Migración API Fideltour (3rd-party) a API V1 HDH

Migración API Fideltour (3rd-party) a API V1 HDH

AUTENTIFICACIÓN

En la API antigua se facilita un TOKEN por cliente al proveedor y este lo usa añade siempre en la cabecera(headers) de todas las peticiones.

En la API actual, es necesaria una petición login para obtener el TOKEN, que posteriormente hay que añadir en la cabecera(headers) del resto de peticiones.

El token caduca a las 24 horas y se recomiendan dos metodos para refrescarlo:

  • Refrescar cuando se recibe un 401,

  • Usar los metodo verify y token-refresh


Cambios relacionados con los contactos

GET a https://backend.fideltour.com/api/3rd-party/contacts/

GET a https://app.hoteldatahub.io/api/v1/contacts/


POST a https://backend.fideltour.com/api/3rd-party/contacts/

POST a https://app.hoteldatahub.io/api/v1/contacts/


PATCH a https://backend.fideltour.com/api/3rd-party/contacts/

PATCH a https://app.hoteldatahub.io/api/v1/contacts/1234566/


  • El atributo "hc" ya no se debe enviar.

  • Los atributos "first_name" y "last_name" se han sustituido por "name" y "surname", respectivamente.

  • Al realizar un PATCH, es necesario incluir el ID del contacto en la url y no es necesario enviar su email en el body


Cambios relacionados con las reservas

GET a https://backend.fideltour.com/api/3rd-party/bookings/ 

GET a https://app.hoteldatahub.io/api/v1/entries/


POST a https://backend.fideltour.com/api/3rd-party/bookings/

POST a https://app.hoteldatahub.io/api/v1/entries/


PATCH a https://backend.fideltour.com/api/3rd-party/bookings/123455/

PATCH a https://app.hoteldatahub.io/api/v1/entries/123455/


  • El atributo "hc" se ha sustituido por "hotel_chain".

  • Al crear una reserva es obligatorio el atributo "contact", donde se envía el ID(integer) del contacto vinculado.

  • Los atributos "checkin" y "checkout" se han sustituido por "entrance" y "departure", respectivamente.

  • En el atributo "hotel" hay que enviar el ID(integer) del hotel, proporcionado por Fideltour.

  • Los atributos "contact_first_name", "contact_last_name", "contact_email" y "contact_phone" ya no se utilizan.

  • Se añaden los siguientes atributos nuevos: "is_checkin_realized", "is_checkout_realized", "sub_status",  "juniors", "room_number", "notes", "fare_type", "offer", "event_type", "package" y "category"


    • Related Articles

    • Introducción

      Primeros pasos Introducción: En este artículo mostramos como consultar y utilizar la API de HotelDataHub/Fideltour a través de la plataforma Swagger. En ella, encontramos los diferentes endpoints(urls) y la información que debemos facilitar en cada ...

    • Loyalty

      Loyalty Introducción: En este artículo hablamos sobre las peticiones de la API relacionadas con el módulo Loyalty de Fideltour. Los apartados del Swagger que incluyen esta información son: https://app.hoteldatahub.io/swagger/#/contacts ...

    • Consentimientos RGPD

      Consentimientos RGPD Introducción: En este artículo hablamos sobre las peticiones de la API, relacionadas con los consentimientos obligatorios del Registro General de Protección de Datos(RGPD o GDPR en inglés), y como gestionarlos en los contactos. ...

    • Gestión de movimientos

      Movimientos Tabla de contenidos Introducción Casos de uso Métodos disponibles Tabla de parámetros Ejemplos Petición (POST) Respuesta (POST) Petición (GET) Respuesta (GET) Petición (PATCH) Respuesta (PATCH) Introducción: En este artículo hablamos ...

    • Otras conexiones

      Otros Introducción: En la API de Hotel Data Hub, encontraremos que se requieren varios valores de tipo numérico, los cuales identifican a un item u elemento en la base de datos de Fideltour. Podemos deducir, que si un item no existe en la base de ...