API Oficial Guías Españoles en el Mundo

Acerca conexión

Es fundamental poseer token proporcionado por diverty (soporte@diverty.es) para poder utilizar el servicio.

Conexión con APi

Ejemplo llamada mediante PHP:

  1. $url = 'https://guias.diverty.es/booking.php?[parametros]';
  2. $ch = curl_init($url);
  3. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
  4. curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
  5. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  6. $data = curl_exec($ch);
  7. curl_close($ch);
  8. $respuesta = json_decode($data, true);

Opciones

Nombre Tipo Descripción
[parametros] - Son aquellos parámetros obligatorios u optativos utilizados para la llamada a las distintas funciones.

Acerca Guías

Listado de guias cercanas a la búsqueda de destino u hotel que esté buscando el usuario.

Ver Guías de Viaje


Información: A partir de unas coordenadas y la distancia que consideres necesearia, podras ver las guías cercanas a un hotel, destino o punto de interés. Recomendamos hacer siempre llamada (es muy rápida y ágil), ya que actualizamos e incorporamos guías constantemente.

Url llamada APi

Es la url base de llamada APi para guias.

  1. https://guias.diverty.es/booking.php?tipo=guias

Parámetros

Nombre Tipo Descripción
token Obligatorio Credencial proporcionada por diverty para poder utilizar el servicio.
lat Obligatorio Latitud del hotel, destino o punto dónde quieras buscar guías cercanas.
longi Obligatorio Longitud del hotel, destino o punto dónde quieras buscar guías cercanas.
distancia Opcional Distancia en kilómetros de guías cercanas al punto buscado. Si no se indica ningún parámetro aparecerán guías situadas hasta 300km de distancia. Si proporcionas una distancia menor de 100km, va a considerar mínimo 100km, ya que hay ciudades cuya contorna es igual a este valor.

Obtener coordenadas: Si dispones de un texto de dirección y no las coordenadas, puedes obtenerlas de forma muy sencilla mediante el APi de Google Maps, para ello debes darte de alta en Google Maps y solicitar una key.
  1. $url = 'https://maps.google.com/maps/api/geocode/json?sensor=false&address=Nueva+York';
  2. $response= file_get_contents($url);
  3. $lat= $json['results'][0]['geometry']['location']['lat'];
  4. $lng= $json['results'][0]['geometry']['location']['lng'];

Respuesta

Nombre Variable Descripción
resultado String Puede tener el valor "OK" o "KO".
mensaje String Explica el resultado de la llamada.
guias array Es un array de elementos de cada una de las guías que cumplen los criterios de la llamada.
| id string ID identificativo de la guía.
| tipo string Tipo de destino que puede tener los valores 'city', 'country', 'island', 'region', 'state' o 'town'.
| pvp_original decimal Precio original de venta de esta guía y que sería el pvp si no existen descuentos.
| pvp decimal Precio oficial de venta en este momento de esta guía. Los precios pueden variar a lo largo del año.
| neto decimal Precio de compra y que coindice con el importe que deberá abonarnos.
| lat decimal Latitud del destino.
| longi decimal Longitud del destino.
| distancia decimal Distancia en km entre las coordenadas proporcionadas y las guías.
| imagen_destino string Url de imágen principal del destino en tamaño 882px ancho por 320px alto.
| imagen_espanoles string Url del logo de Españoles en el Mundo en tamaño 1200px ancho por 350px alto.
| url_guia string Url de la guía oficial de Españoles en el Mundo.
| descripcion_corta string Descripción corta del destino de la guía.
| descripcion_larga string Descripción larga del destino de la guía.
| ubicaciones_documentadas integer Número de ubicaciones documentadas en la guía.
| ubicaciones_destacadas integer Número de ubicaciones destacadas en la guía.
| rutas_recomendadas integer Rutas a pié diseñadas para disfrutar del destino y realizadas por guías expertos. Este campo es el único que puede no venir en la respuesta, por lo que solamente debe mostrarse en caso que lo devuelva la respuesta.

Acerca Reservar

Confirmación de contratación de guía de viaje.

Confirmar Guía


Información: Indicar como dato destacable que las guías de viaje son siempre no reembolsables. Destacar que el campo activacion es de obligatoria información al comprador.

Url llamada APi

Es la url base de llamada APi para reservar.

  1. https://guias.diverty.es/booking.php?tipo=reservar

Parámetros

Nombre Tipo Descripción
token Obligatorio Credencial proporcionada por diverty para poder utilizar el servicio.
id Obligatorio ID identificativo de la guía.

Respuesta

Nombre Variable Descripción
resultado String Puede tener el valor "OK" o "KO".
mensaje String Explica el resultado de la llamada.
referencia String Referencia única de la guía y campo preciso para activar la guía.
activacion String Debe visitar la web guias.diverty.es y registrarte/loguerte. Una vez accedido debe pulsar en el item de memú "AGREGAR / VER MIS GUÍAS" y pulsar en el botón "AGREGAR GUÍA". En este formulario debe introducir la referencia única de la guía.

Acerca Listar Reservas

Listado de mis guías reservadas.

Ver Reservas

Url llamada APi

Es la url base de llamada APi para reservar.

  1. https://guias.diverty.es/booking.php?tipo=listar

Parámetros

Nombre Tipo Descripción
token Obligatorio Credencial proporcionada por diverty para poder utilizar el servicio.

Respuesta

Nombre Variable Descripción
resultado String Puede tener el valor "OK" o "KO".
mensaje String Explica el resultado de la llamada.
reservas array Es un array de elementos de cada una de las reservas realizadas.
| fechaTransaccion string Fecha en que ha sido realizada reserva.
| id string ID identificativo de la guía.
| referencia string Referencia única de la guía y campo preciso para activar la guía.
| pvp decimal Precio oficial de venta en este momento de esta guía. Los precios pueden variar a lo largo del año.
| neto decimal Precio de compra y que coindice con el importe que deberá abonarnos.