Mediante la API (Interfaz de Programación de Aplicaciones) de Clubrural puedes mostrar nuestras casas rurales en tu propia web. La API de Clubrural te mostrará información de las casas rurales de una provincia o cercanas a un punto geolocalizado.
Tienes 2 tipos de llamadas, por geolocalización:
https://api.clubrural.com/api.php?claveapi=xxxxxx&type=gmaps&lat=43.419514&lng=-4.750915&limitkm=5
y por provincias:
https://api.clubrural.com/api.php?claveapi=xxxxxx&type=provincias&idprov=28
claveapi: clave que se facilita al registrarse como usuario de la api
type: podemos utilizar dos opciones:
En el caso de elegir gmaps:
lat y lng: latitud y longitud
limitkm(opcional): area de kilómetros a la redonda donde buscará alojamientos respecto a lat y lng. (máximo de 100km por defecto 30km)
En el caso de elegir provincias:
idprov: Id de provincia (Descargar tabla de provincias)
Los resultados se mostrarán en formato XML (ejemplo)
<?xml version="1.0" encoding="iso-8859-1" ?>
<api>
<count>9</count>
<alojamiento>
<img>https://media.clubrural.com/thumbs100x75/espana/casa-rural/1_casa-rural_m.jpg</img>
<nombre>Apartamentos Santana</nombre>
<tipo>Apartamento Rural</tipo>
<alquiler>Apartamentos</alquiler>
<provincia>Asturias</provincia>
<localidad>Llanes</localidad>
<precio>22</precio>
<plazas>10</plazas>
<url>https://www.clubrural.com/casa-rural/espana/casa-rural_1</url>
<lat>43.419514</lat>
<lng>-4.750915</lng>
<km>0</km>
</alojamiento>
</api>
"count" es el número total de alojamientos encontrados.
Entre las etiquetas alojamiento podemos encontrar los datos referentes a cada establecimiento.
"km" solo aparece en el caso de haber seleccionado el tipo por geolocalización y nos indica la distancia apróximada al punto indicado.
"precio" hace referencia al mejor precio por persona/noche.
Si tienes alguna duda o sugerencia sobre la api contacta con nosotros en api[arroba]clubrural.com
Registrate para conseguir la clave api.