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

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

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

    • Migración API Fideltour V2 --> API HotelDataHub V1

      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 ...
    • 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 reservas

      Tabla de contenidos: Introducción Casos de uso Métodos disponibles Tabla de parámetros Ejemplos: Petición (POST) Introducción: En este artículo hablamos sobre las peticiones de la API relacionadas con los Bookings. Procesar un booking: El endpoint se ...