Este año parece que los Reyes Magos han dejado un bonito regalo a todos los desarrolladores: a partir de ahora está a disposición de quien lo desee la API de tendumi. Mediante esta nueva funcionalidad queremos ofrecer la posibilidad de poder consumir y utilizar los contenidos de tendumi desde cualquier web o aplicación externa.

La API está basada en la tećnica REST API, por lo tanto obtener los contenidos de tendumi es tan sencillo como invocar una dirección web o URL. Una vez realizada la llamada se recibe un fichero JSON como respuesta, el cual contiene todos los datos relativos a los campings deseados. El uso de la API de tendumi es muy sencillo, veamos paso a paso cómo podemos trabajar con ella:

1. Antes de empezar a utilizar la API es necesario realizar una petición para obtener la clave de uso, por tanto simplemente tenéis que ir a la página de contacto de tendumi, escribir que estáis interesados en utilizar la API e indicar en qué web o aplicación queréis visualizar los datos (o poner que simplemente queréis trastear). Una vez recibáis un e-mail con vuestra clave podréis seguir con el siguiente paso.
2. Introducir en el navegador la siguiente URL: http://www.tendumi.com/api/000000000/campings/-1/-1/-1/-1

El significado de los parámetros de la URL es el siguiente:

1. “000000000″ : La clave de uso de la API.
2. “campings” : Queremos obtener los campings. Por ahora no existe ninguna otra posibilidad, pero en un futuro tal vez se puedan consumir otros datos.
3. “-1″ :  Cualquier país.  Si queréis indicar un país en concreto podéis consultar los códigos de los países (pdf) que tenemos en nuestra base de datos.
4. “-1″ :  Cualquier comunidad autónoma. Todos los códigos de las comunidades autónomas (pdf).
5. “-1″ :  Cualquier provincia. Todos los códigos de las provincias (pdf).
6. Cualquier ciudad. Todos los códigos de las ciudades (pdf).

Como podréis observar vuestro navegador os devolverá un fichero en formato JSON parecido a este:

{
"total":1,
"campings":[
{
"id":"1",
"name":"Camping - Hotel Playa la Arena",
"url":"\/camping-hotel-playa-la-arena\/1",
"picture":"http:\/\/www.tendumi.com\/img\/camping\/thumbnail\/summary\/camping-hotel-playa-la-arena.jpg",
"pictures_number":10,
"price_avg":12,
"comments":2,
"stars":3,
"city":"Isla",
"province":"Cantabria",
"community":"Cantabria",
"latitude":"43.500000",
"longitude":"-3.580000",
}
]
}

Pues nada, ¡si estáis interesados en utilizar nuestra API no perdáis la oportunidad y pedir vuestra clave cuanto antes!