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

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 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


Por cada cliente que quiera utilizar la integración, Fideltour proporcionara la siguiente información:
  1. username
  2. password
  3. hotel_chain
  4. ID de cada hotel


Cambios relacionados con los contactos

GET a https://backend.fideltour.com/api/v2/contacts/

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


POST a https://backend.fideltour.com/api/v2/contacts/

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


PATCH a https://backend.fideltour.com/api/v2/contacts/1234566

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


  • Para filtrar contactos por email usar el filtro "email__iexact"

  • El atributo "email_status" no se debe enviar.

  • El atributo "phone2" ya no existe

  • Las opciones del campo gender se han ampliado: 

    • 0 = no especificado (default)

    • 1 = hombre

    • 2 = mujer

    • 3 = no binario

    • 4 = género fluido

    • 5 = prefiere no decirlo

  • El contenido del atributo "custom_tags" debe ser una listado de strings.

  • Los campos "province", "town" y "zone" se deben enviar como Strings.

  • 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/v2/entries/

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


POST a https://backend.fideltour.com/api/v2/entries/

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


PATCH a https://backend.fideltour.com/api/v2/entries/123455/

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


  • Para buscar una entry en Fideltour, usar los filtros: "localizer" + "input_channel__in"

  •  El atributo "currency" debe ser ISO 4217

  • Se añaden los siguientes atributos:

    • "is_checkin_realized",

    • "is_checkout_realized",

    • "sub_status",  

    • "juniors",

    • "notes",

    • "fare_type",

    • "offer",

    • "event_type",

    • "package",

    • "category"

  • En los atributos "regime", "room_type", "fare_type", "offer", "event_type", "package" y "category" enviar un String


    • Related Articles

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

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