API de Minube

¿Cómo hacer las peticiones?

Lo primero que tienes que hacer es tener tu llave de acceso, esta la pides con el registro que tenemos aqui mismo. Algo importante que debes recordar que esta llave debe de ir incluida en todas tus peticiones. Las peticiones se hacen al más puro estilo de REST, asi que solo tendrás que hacer una petición a URLs como esta:

http://api.minube.com/locations/countries.xml?api_key=tullaveaqui

Las respuestas son en XML, aún en las que hayan resultado datos vacios o en las que haya ocurrido un error. Puedes saber el estado de cada respuesta directamente en el primer atributo "status" del elemento "response".

JSON

Además de tener las respuestas en formato XML, tenemos disponible JSON para aquellos que prefieran trabajar con Javascript. El único cambio a realizar es en la URL de la petición, cambiando el .xml a .json, de forma que quede:

http://api.minube.com/locations/countries.json?api_key=tullaveaqui

La estructura de los objetos es la misma que en la respuesta XML equivalente.

Además de los parámetros indicados en cada sección, las peticiones realizadas en JSON soportan un parámetro adicional: callback. Este parámetro permite realizar operaciones sobre los resultados devueltos en la petición, sin tener que manipularlos internamente en el código. Por ejemplo, suponiendo que en tu código incluyas lo siguiente:

<script type="text/javascript">
function foo(bar)
{
 for(var x=0; x<bar.response.countries.length; x++)
 alert(bar.response.countries[x].name + " tiene " +
 bar.response.countries[x].pois_count + " rincones!");
}
</script>
<script src="http://api.minube.com/locations/countries.json?
callback=foo&limit=5&api_key=tullaveaqui"></script>

Al momento de cargar la página, ejecutaría la función foo, enviándole como parámetro la respuesta de la petición realizada, resultando en una serie de alertas informándo al usuario de la cantidad de rincones en cada país. De esta manera, se pueden procesar los datos recibidos de una manera sencilla y transparente, filtrandolos para trabajar exclusivamente con lo requerido, o cambiándole el formato a la respuesta para que sea empleada en alguna otra función en el código, por ejemplo.

Sistema de Tickets

Para cada aplicación tenemos un límite de tickets que se pueden hacer mensualmente. Un ticket es el costo que nosotros le damos a una petición ya que unas son más complicadas que otras. Por el momento estamos en fase experimental y de pruebas, asi que cada petición solo vale 1 ticket, pero en el futuro ajustaremos estos costes de acuerdo a su uso. Solo recuerda no rebasar tu límite de tickets que es de 2000 mensuales.

Documentación de métodos

Parámetros

• Sin parámetros devuelve todos los países.
• id (opcional): Id del país a buscar.
• name (opcional): Nombre del país a buscar.
• order (opcional): Ordenar resultados por:
  [pois_count*, name, id, full_count, see_count, restaurant_count, blog_count, hotel_count].
• limit (opcional): Límite de resultados.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/locations/countries.xml?api_key=xx&name=italia

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="1">
 <countries>
 <country>
 <id>104</id>
 <name>Italia</name>
 <pois_count>5021</pois_count>
 <full_count>734</full_count>
 <see_count>602</see_count>
 <restaurant_count>57</restaurant_count>
 <blog_count>23</blog_count>
 <hotel_count>13237</hotel_count>
 <latitude>41.871941</latitude>
 <longitude>12.567380</longitude>
 </country>
 </countries>
</response>
 

Parámetros

• Sin parámetros devuelve todas las ciudades.
• id (opcional): Id de la ciudad a buscar.
• name (opcional): Nombre de la ciudad a buscar.
• country (opcional): Nombre o id del país al que pertenece la ciudad.
• order (opcional): Ordenar resultados por:
  [pois_count*, name, id, full_count, see_count, restaurant_count, blog_count, hotel_count].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/locations/cities.xml?api_key=xx&name=madrid

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="8">
 <cities>
 <city>
 <id>1252</id>
 <name>Madrid</name>
 <pois_count>2051</pois_count>
 <full_count>966</full_count>
 <see_count>607</see_count>
 <restaurant_count>315</restaurant_count>
 <blog_count>14</blog_count>
 <hotel_count>415</hotel_count>
 <latitude>40.416706</latitude>
 <longitude>-3.703270</longitude>
 <country>
 <id>63</id>
 <name>España</name>
 </country>
 </city>
 </cities>
</response>
 

Parámetros

• Sin parámetros devuelve todas las categorías.
• id (opcional): Id de la categoría a buscar.
• name (opcional): Nombre de la categoría a buscar.
• supercategory (opcional): Id de la supercategoría a buscar.
• order (opcional): Ordenar resultados por: [name*, id, group].
• limit (opcional): Límite de resultados.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/places/categories.xml?api_key=xx

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="135">
 <categories>
 <category>
 <id>131</id>
 <name>Abadias</name>
 <supercategory>2</supercategory> 
 <group>tosee</group> 
 </category>
 </categories>
</response>
 

Parámetros

• Sin parámetros devuelve todas las supercategorías.
• id (opcional): Id de la supercategorías a buscar.
• name (opcional): Nombre de la supercategorías a buscar.
• order (opcional): Ordenar resultados por: [name*, id, group].
• limit (opcional): Límite de resultados.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/places/supercategories.xml?api_key=xx

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="8">
 <supercategories>
 <supercategory>
 <id>2</id>
 <name>Cultura</name>
 </supercategory>
 </supecategories>
</response>
 

Parámetros

• Sin parámetros devuelve el máximo de rincones.
• id (opcional): Id del rincón a buscar.
• city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
• country (opcional): Nombre o id del país donde se encuentra el rincón.
• category (opcional): Nombre o id de la categoría del rincón.
• supercategory (opcional): Id de la supercategoría del rincón.
• category_group (opcional): Grupo de categorías.
• order (opcional): Ordenar resultados por: [date*, id, views, comments, total_score].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/places/pois.xml?api_key=xx&city=madrid&country=espa%C3%B1a

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="4189">
 <pois>
 <poi>
 <id>70489</id>
 <name><![CDATA[Restaurante Kabuki Wellington]]></name>
 <date>2009-05-21 01:51:37</date>
 <address><![CDATA[Calle de Velazquez 6]]></address>
 <zip_code><![CDATA[55555]]></zip_code>
 <telephone><![CDATA[123456789]]></telephone>
 <website><![CDATA[http://www.example.com]]></website>
 <comments>0</comments>
 <views>1</views>
 <latitude>40.421833</latitude>
 <longitude>-3.684441</longitude>
 <url>http://www.minube.com/rincon/70489</url>
 <category>
 <id>29</id>
 <name>Restaurantes</name>
 <group>eat</group>
 </category>
 <supercategory>
 <id>3</id>
 </supercategory> 
 <country>
 <id>63</id>
 <name>España</name>
 </country>
 <city>
 <id>1252</id>
 <name>Madrid</name>
 </city>
 </poi>
 </pois>
</response>
 

Parámetros

• Sin parámetros devuelve todos los comentarios.
• id (opcional): Id del comentario a buscar.
• user (opcional): Nombre o id del usuario propietario del comentario.
• poi (opcional): Id del rincón a buscar.
• category (opcional): Nombre o id de la categoría del rincón.
• supercategory (opcional): Id de la supercategoría del rincón.
• category_group (opcional): Grupo de categorías.
• country (opcional): Nombre o id del país donde se encuentra el rincón.
• city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
• order (opcional): Ordenar resultados por: [date*, id].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/places/comments.xml?api_key=xx&country=francia&category=teatros

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="17">
 <comments>
 <comment>
 <id>66441</id>
 <date>2007-11-12 00:00:00</date>
 <content><![CDATA[Este teatro esta situado en la ciudad de Paris, en el 
distrito 13, y ofrece un numero variado de muestras: se centra en piezas clasicas del 
teatro (Shakespeare, Racine, etc.), y ofrece conciertos de todo tipo. Los precios son 
interesantes por la calidad de los actores, los musicos y el sonido de 
la sala.]]></content>
 <poi>
 <id>68530</id>
 <name><![CDATA[Teatro 13]]></name>
 <url>http://www.minube.com/rincon/68530</url>
 <category>
 <id>92</id>
 <name>Teatros</name>
 <group>tosee</group>
 </category>
 <supercategory>
 <id>5</id>
 </supercategory> 
 <user>
 <id>54275</id>
 <username>matthieu1985</username>
 <avatar>http://d1epe1pw3j6w9q.cloudfront.net/0_80x80.jpg</avatar>
 <url>http://www.minube.com/viajero/matthieu1985</url>
 </user>
 <country>
 <id>71</id>
 <name>Francia</name>
 </country>
 <city>
 <id>1401</id>
 <name>Paris</name>
 </city>
 </poi>
 </comment>
 </comments>
</response>
 

Parámetros

• id (requerido): Id del rincón a buscar.
• category (opcional): Nombre o id de la categoría de los rincones cercanos.
• supercategory (opcional): Id de la supercategoría de los rincones cercanos.
• category_group (opcional): Grupo de categorías.
• order (opcional): Ordenar resultados por: [views, id, date, comments, distance, popularity*].
• distance (opcional): Distancia máxima (metros) al rincon.
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/places/nearby.xml?api_key=xx&id=70489&category=restaurantes

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="2212">
 <pois>
 <poi>
 <id>543</id>
 <name><![CDATA[Restaurante Ojala]]></name>
 <date>2007-11-27 13:32:41</date>
 <address><![CDATA[San Andres 1]]></address>
 <zip_code><![CDATA[28004]]></zip_code>
 <telephone><![CDATA[91 523 27 47]]></telephone>
 <website><![CDATA[http://]]></website>
 <comments>2</comments>
 <views>13356</views>
 <latitude>40.425533</latitude>
 <longitude>-3.703945</longitude>
 <url>http://www.minube.com/rincon/543</url>
 <distance>1703.4</distance>
 <category>
 <id>29</id>
 <name>Restaurantes</name>
 <group>eat</group>
 </category>
 <supercategory>
 <id>3</id>
 </supercategory> 
 <country>
 <id>63</id>
 <name>España</name>
 </country>
 <city>
 <id>1252</id>
 <name>Madrid</name>
 </city>
 </poi>
 </pois>
</response>
 

Parámetros

• latitude (requerido): Latitud deseada.
• longitude (requerido): Longitud deseada.
• distance (opcional): Distancia máxima (metros) a la coordenada dada. 500mts por defecto.
• category (opcional): Nombre o id de la categoría de los rincones cercanos.
• supercategory (opcional): Id de la supercategoría de los rincones cercanos.
• category_group (opcional): Grupo de categorías.
• order (opcional): Ordenar resultados por: [views, id, date, comments, popularity, distance*].
• limit (opcional): Límite de resultados. 50 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/places/coordinates.xml?api_key=xx&latitude=52.2679&longitude=4.54327

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="1">
 <pois>
 <poi>
 <id>95</id>
 <name><![CDATA[Keukenhof]]></name>
 <distance>1.11508095705312</distance>
 <date>2007-10-17 10:47:08</date>
 <address><![CDATA[Stationsweg 166a]]></address>
 <zip_code><![CDATA[2161]]></zip_code>
 <telephone><![CDATA[+31 (0) 252 465 555]]></telephone>
 <website><![CDATA[http://www.keukenhof.nl/nm/espagnol.html]]</website>
 <comments>4</comments>
 <views>618</views>
 <latitude>52.267910</latitude>
 <longitude>4.543269</longitude>
 <url>http://www.minube.com/rincon/95</url>
 <category>
 <id>4</id>
 <name>Reservas Naturales</name>
 <group>tosee</group>
 </category>
 <supercategory>
 <id>1</id>
 </supercategory> 
 <country>
 <id>90</id>
 <name>Holanda</name>
 </country>
 <city>
 <id>249236</id>
 <name>Lisse</name>
 </city>
 </poi>
 </pois>
</response>
 

Parámetros

• Sin parámetros devuelve el máximo posible de fotos.
• id (opcional): Id de la foto a buscar.
• poi (opcional): Id del rincón de la foto.
• country (opcional): Nombre o id del país donde se encuentra el rincón.
• city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
• category (opcional): Nombre o id de la categoría del rincón.
• order (opcional): Ordenar resultados por: [date*, id, views, comments].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/media/pictures.xml?api_key=xx&city=boston

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="55">
 <pictures>
 <picture>
 <id>195046</id>
 <views>76</views>
 <date>2009-01-28 13:52:50</date>
 <url>http://d9ptcxk3xvglv.cloudfront.net/8b2da2bd6f60372f5ea30fa0d2a5e0c5</url>
 <url_thumbnail>http://d3kcd42x74asen.cloudfront.net/8b2da2bd6f60372f5ea30fa0d2a5e0c5</url_thumbnail>
 <user>
 <id>52341</id>
 <username>p4bl0</username>
 <url>http://www.minube.com/viajero/p4bl0</url>
 </user>
 <poi>
 <id>36423</id>
 <name><![CDATA[Prudential Tower]]></name>
 <category>Miradores</category>
 <url>http://www.minube.com/rincon/36423</url>
 </poi>
 <country>
 <id>242</id>
 <name>Estados Unidos</name>
 </country>
 <city>
 <id>145650</id>
 <name>Boston</name>
 </city>
 </picture>
 </pictures>
</response>
 

Parámetros

• Sin parámetros devuelve el máximo posible de comentarios.
• id (opcional): Id del comentario a buscar.
• picture_id (opcional): Id de la foto.
• order (opcional): Ordenar resultados por: [date*, id, picture_id].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/media/picture_comments.xml?api_key=xx&picture_id=359790

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="1">
 <picture_comments>
 <picture_comment>
 <id>8717</id>
 <content><![CDATA[Magnificooooooo!!!!!felicitaciones. Saludos]]></content>
 <date>2009-05-21 04:13:07</date>
 <user>
 <id>53698</id>
 <username>martapilar</username>
 <url>http://www.minube.com/viajero/martapilar</url>
 </user>
 <picture>
 <id>359790</id>
 <poi_id>70416</poi_id>
 <url>http://d9ptcxk3xvglv.cloudfront.net/224f9027d45aed5a2ab0b5f510497067</url>
 </picture>
 </picture_comment>
 </picture_comments>
</response>
 

Parámetros

• Sin parámetros devuelve el máximo posible de videos.
• id (opcional): Id del video a buscar.
• poi (opcional): Id del rincón del video.
• country (opcional): Nombre o id del país donde se encuentra el rincón.
• city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
• category (opcional): Nombre o id de la categoría del rincón.
• order (opcional): Ordenar resultados por: [date*, id, views].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/media/videos.xml?api_key=xx&city=roma

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="15">
 <videos>
 <video>
 <id>1932</id>
 <views>74</views>
 <date>2009-03-05 17:07:02</date>
 <url>http://www.minube.com/videos/rincon/2551/1932</url>
 <user>
 <id>51221</id>
 <username>Mou</username>
 <url>http://www.minube.com/viajero/Mou</url>
 </user>
 <poi>
 <id>2551</id>
 <name><![CDATA[Vistas desde el Coliseo]]></name>
 <category>De interes turistico</category>
 <url>http://www.minube.com/rincon/2551</url>
 </poi>
 <country>
 <id>104</id>
 <name>Italia</name>
 </country>
 <city>
 <id>1878</id>
 <name>Roma</name>
 </city>
 </video>
 </videos>
</response>
 

Parámetros

• Sin parámetros devuelve el máximo posible de comentarios.
• id (opcional): Id del comentario a buscar.
• video_id (opcional): Id del video.
• order (opcional): Ordenar resultados por: [date*, id, video_id].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/media/video_comments.xml?api_key=xx

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="1194">
 <video_comments>
 <video_comment>
 <id>582</id>
 <content><![CDATA[Asi es Naxos, tal y como estan las cosas con un vuelo barato 
te sale rentable y ademas disfrutas de un lugar realmente espectacular porque ademas 
me olvide decir que esta propia casa que alquila los chalets organiza excursiones de 
todo tipo por toda la isla a precios de risa ademas que decir de lo que cuesta comer 
por libre en Tailandia. Saludos.]]></content>
 <date>2009-05-20 13:10:16</date>
 <user>
 <id>54173</id>
 <username>miguelangelcartagena</username>
 <url>http://www.minube.com/viajero/miguelangelcartagena</url>
 </user>
 <video>
 <id>2949</id>
 <poi_id>70380</poi_id>
 <url>http://www.minube.com/videos/rincon/70380/2949</url>
 </video>
 </video_comment>
 </video_comments>
</response>
 

Parámetros

• Sin parámetros devuelve el máximo posible de vuelos.
• source_iata (opcional): Código IATA del aeropuerto origen.
• source_city (opcional): Nombre o id de la ciudad origen.
• source_country (opcional): Nombre o id del país origen.
• destination_iata (opcional): Código IATA del aeropuerto destino.
• destination_city (opcional): Nombre o id de la ciudad destino.
• destination_country (opcional): Nombre o id del país destino.
• order (opcional): Ordenar resultados por: [best_price*, depart_date, return_date].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/buzz/flights.xml?api_key=xx&source_country=espa%C3%B1a&source_city=madrid

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="15279">
 <flights>
 <flight>
 <best_price>20.98</best_price>
 <depart_date>2009-06-07</depart_date>
 <return_date>2009-06-14</return_date>
 <url>http://www.minube.com/homes/flights/1190948</url>
 <source_city>
 <id>1252</id>
 <name>Madrid</name>
 </source_city>
 <source_country>
 <id>63</id>
 <name>España</name>
 </source_country>
 <destination_city>
 <id>1261</id>
 <name>Santander</name>
 </destination_city>
 <destination_country>
 <id>63</id>
 <name>España</name>
 </destination_country>
 </flight>
 </flights>
</response>
 

Parámetros

• Sin parámetros devuelve la lista entera de ciudades.
• source_city (opcional): ID de la ciudad origen del vuelo.
• source_iata (opcional): Código IATA del aeropuerto origen.
• destination_city (opcional): Nombre o id de la ciudad destino.
• destination_iata (opcional): Código IATA del aeropuerto destino.
• order (opcional): Ordenar resultados por: [name*, pois_count, id, full_count, see_count, restaurant_count, blog_count, hotel_count].
• limit (opcional): Límite de resultados. 20 por defecto.
• page (opcional): Página de resultados. 1 por defecto.

Un ejemplo de petición:

http://api.minube.com/buzz/cities.xml?api_key=xx&source_iata=MAD&limit=1

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="15279">
 <cities>
 <city>
 <id>1248</id>
 <name>A Coruña</name>
 <pois_count>288</pois_count>
 <full_count>222</full_count>
 <see_count>164</see_count>
 <restaurant_count>55</restaurant_count>
 <blog_count>0</blog_count>
 <hotel_count>21</hotel_count>
 <latitude>43.371490</latitude>
 <longitude>-8.395970</longitude>
 <country>
 <id>63</id>
 <name>España</name>
 </country>
 </city>
 </cities>
</response>
 

Parámetros

• source_iata (requerido): Código IATA del aeropuerto de origen.
• destiny_iata (requerido): Código IATA del aeropuerto de destino.
• depart_date (opcional): Fecha de salida en formato AAAA-MM-DD. Por defecto el día siguiente.
• depart_time (opcional): Hora del vuelo de salida: 'anytime'*, 'early', 'morning', 'afternoon', 'night'.
• return_date (opcional): Fecha de regreso en formato AAAA-MM-DD. Por defecto dos días después de la fecha actual.
• return_time (opcional): Hora del vuelo de regreso: 'anytime'*, 'early', 'morning', 'afternoon', 'night'.
• adults (opcional): Cantidad de adultos en el vuelo. Por defecto 1.
• children (opcional): Cantidad de niños en el vuelo. Por defecto 0.
• babies (opcional): Cantidad de bebes en el vuelo. Por defecto 0.
• stops (opcional): Vuelo con o sin paradas: 'with_stops'* o 'direct'
• source_nearby_airport (opcional): Permitir aeropuertos cercanos al origen. 'true' o 'false'*
• destiny_nearby_airport (opcional): Permitir aeropuertos cercanos al destino. 'true' o 'false'*

Un ejemplo de petición:

http://api.minube.com/search/flights.json?api_key=xx&source_iata=MAD&destiny_iata=BCN

Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="#">
 <search>
 <id>14e59da61b53572ff0e43aad356d65c0</id>
 </search>
</response>
 

Parámetros

• city (requerido): Ciudad en la que se buscaran hoteles.
• country (requerido): País al que pertenece dicha ciudad.
• date_in (opcional): Fecha de entrada en formato AAAA-MM-DD. Por defecto una semana después de la fecha actual.
• date_out (opcional): Fecha de salida en formato AAAA-MM-DD. Por defecto dos semanas después de la fecha actual.
• rooms (opcional): Cantidad de habitaciones deseadas.
• adults (opcional): Cantidad de adultos en el vuelo. Por defecto 2.
• children (opcional): Cantidad de niños en el vuelo. Por defecto 0.

Un ejemplo de petición:

http://api.minube.com/search/lodges.json?api_key=xx&city=Madrid&country=Espa%C3%B1a

Tip: ¡No olviden codificar los parámetros de la búsqueda! En Javascript, se emplea la función encodeURIComponent. En PHP, se usa urlencode. Un ejemplo de la respuesta XML:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="#">
 <search>
 <id>e17afb268eee5f081b9a19ee32a83421</id>
 </search>
</response>
 

Parámetros

• sid (requerido): ID de la búsqueda de la que se desean los resultados.
• type (requerido): Tipo de búsqueda lanzada: 'flights'* o 'lodges'

Un ejemplo de petición:

http://api.minube.com/search/fetch.json?api_key=xx&type=lodges&sid=e17afb268eee5f081b9a19ee32a83421

La respuesta puede ser de dos tipos: búsqueda concluida o búsqueda en curso.
En el caso de búsqueda en curso de devolverá el total de proveedores sobre el que se esta desarrollando la consulta y el número de ellos que han terminado con exito. Un ejemplo de respuesta XML :

 <?xml version="1.0" encoding="UTF-8"?>
 <response status="ok" total="#">
 <search_status>ongoing</search_status>
 <providers>
 <completed>18</completed>
 <total>22</total>
 </providers>
 </response>
 

En el caso de búsqueda concluida se devolverá, también, el total de proveedores sobre el que se desarrolló la consulta y el número de ellos que terminaron con exito. Además, se devolverá un listado de resultados de vuelos y de hoteles para la consulta elegida.
Un ejemplo abreviado de la respuesta XML para una búsqueda de hoteles:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="#">
 <search_status>complete</search_status>
 <providers>
 <completed>22</completed>
 <total>22</total>
 </providers>
 <lodges>
 <lodge>
 <distance>4520.5</distance>
 <hotel_id>32350</hotel_id>
 <latitude>40.469717775782600</latitude>
 <longitude>-3.685820658704060</longitude>
 <normalized>25 foxa suite</normalized>
 <price>0</price>
 <rating>4</rating>
 <address><![CDATA[Agustín de Foxa, 25]]></address>
 <hotel_company><![CDATA[Desconocido]]></hotel_company>
 <hotel_type><![CDATA[Hotel]]></hotel_type>
 <hotelurl><![CDATA[http://www.nomaders.com//minube/track.aspx?CityCode=6396&StartDate=12/10/2009&EndDate=19/10/2009&Type=SingleHotel&Rooms=1&Kids=0&Adults=2&HotelId=a28014d2-2716-4820-869b-cfd6d29859e7&src=MI]]></hotelurl>
 <imageurl><![CDATA[http://www.venere.com//img/hotel/8/1/1/1/111118/image_hotel_exterior_outside_1.jpg]]></imageurl>
 <name><![CDATA[Hotel Suite Foxa 25]]></name>
 <shop><![CDATA[Nomaders]]></shop>
 <providers>
 <provider>
 <activado>1</activado>
 <price>0</price>
 <deeplink><![CDATA[http://www.nomaders.com//minube/track.aspx?CityCode=6396&StartDate=12/10/2009&EndDate=19/10/2009&Type=SingleHotel&Rooms=1&Kids=0&Adults=2&HotelId=a28014d2-2716-4820-869b-cfd6d29859e7&src=MI]]></deeplink>
 <shop><![CDATA[Nomaders]]></shop>
 </provider>
 </providers>
 <amenities>
 <amenity><![CDATA[Internet]]></amenity>
 <amenity><![CDATA[Parking]]></amenity>
 <amenity><![CDATA[Bar / Restaurante]]></amenity>
 </amenities>
 </lodge>
 </lodges>
</response>
 

Un ejemplo abreviado de la respuesta XML para una búsqueda de vuelos:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok" total="#">
 <providers>
 <completed>15</completed>
 <total>15</total>
 </providers>
 <flights>
 <flight>
 <duration>9000</duration>
 <duration_simple>4800</duration_simple>
 <extra_cost>0</extra_cost>
 <mcarriers>N</mcarriers>
 <price>90</price>
 <deeplink><![CDATA[http://eulerian.govoyages.com/dynclick/govolo-es/?etf-name=Flux%20minube%20-%20Vol&etf-prdref=VOL&ref=2007102301&vildep=MAD&Vilarr=BCN&DatDep=061009&DatArr=071009&AllRet=oui&Adultes=1&ENFANTS=0&BEBES=0&TypeClasse=0&langue=es&eurl=http://www.advences.com/mirror/listevols.cfm]]></deeplink>
 <shop><![CDATA[Govolo]]></shop>
 <flightGo>
 <arrival>BCN</arrival>
 <arrivalTZ>60</arrivalTZ>
 <arrivaldate>2009-10-06</arrivaldate>
 <arrivaltime>22:15</arrivaltime>
 <date>2009-10-06</date>
 <departure>MAD</departure>
 <departureTZ>60</departureTZ>
 <flightcode>UX</flightcode>
 <stops>0</stops>
 <time>20:55</time>
 <type>Economica</type>
 <airline><![CDATA[Air Europa]]></airline>
 <arrival_city><![CDATA[Barcelona]]></arrival_city>
 <departure_city><![CDATA[Madrid]]></departure_city>
 <arrivalName><![CDATA[Barcelona]]></arrivalName>
 <departureName><![CDATA[Barajas]]></departureName>
 </flightGo>
 <flightReturn>
 <arrival>MAD</arrival>
 <arrivalTZ>60</arrivalTZ>
 <arrivaldate>2009-10-07</arrivaldate>
 <arrivaltime>10:20</arrivaltime>
 <date>2009-10-07</date>
 <departure>BCN</departure>
 <departureTZ>60</departureTZ>
 <flightcode>UX</flightcode>
 <stops>0</stops>
 <time>09:10</time>
 <type>Economica</type>
 <airline><![CDATA[UX]]></airline>
 <arrival_city><![CDATA[Madrid]]></arrival_city>
 <departure_city><![CDATA[Barcelona]]></departure_city>
 <arrivalName><![CDATA[Barajas]]></arrivalName>
 <departureName><![CDATA[Barcelona]]></departureName>
 </flightReturn>
 <providers>
 <provider>
 <activado>1</activado>
 <price>90</price>
 <deeplink><![CDATA[http://eulerian.govoyages.com/dynclick/govolo-es/?etf-name=Flux%20minube%20-%20Vol&etf-prdref=VOL&ref=2007102301&vildep=MAD&Vilarr=BCN&DatDep=061009&DatArr=071009&AllRet=oui&Adultes=1&ENFANTS=0&BEBES=0&TypeClasse=0&langue=es&eurl=http://www.advences.com/mirror/listevols.cfm]]></deeplink>
 <shop><![CDATA[Govolo]]></shop>
 </provider>
 <provider>
 <activado>1</activado>
 <price>143.8</price>
 <deeplink><![CDATA[http://www.barceloviajes.com/sites/all/vuelos/valoracion.jsp?tprod=VUE&id=170&sistema=AMA&sesion=V174460810&eticket=S&utm_source=MINUBE&est=1&utm_medium=feed_afiliado&utm_term=vuelos]]></deeplink>
 <shop><![CDATA[Barcelo Viajes]]></shop>
 </provider>
 </providers>
 </flight>
 </flights>
</response>