Context Agent

Tabla de Contenidos¶

• Introducción
• Principio de integración
• Autenticación
• Métodos disponibles
• Cuerpo de la petición
• Ejemplos
• Respuestas

Introducción¶

Este endpoint permite resolver el contexto de un agente. HotelDataHub actúa como puente (pass-through): recibe la petición, la reenvía a Fideltour con el token del cliente y devuelve la respuesta de Fideltour tal cual (mismo código de estado y mismo cuerpo).

HotelDataHub no transforma ni interpreta el cuerpo de la petición: solo lo reenvía y delega la lógica en Fideltour.

Es necesario que el apiuser posea el permiso "context-agent" para utilizar este endpoint.

Principio de integración¶

El cliente llama a HotelDataHub con su token
  ↓
HotelDataHub reenvía la petición a Fideltour (mismo cuerpo)
  ↓
Fideltour identifica la cuenta mediante el token y resuelve el contexto
  ↓
HotelDataHub devuelve la respuesta de Fideltour sin modificarla

Autenticación¶

Cada cuenta integrada tiene un token específico que identifica al cliente (hotel chain). El token se envía en la cabecera Authorization.

Authorization: Token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Métodos disponibles¶

Cuerpo de la petición¶

<PENDIENTE: esquema exacto del payload.> HotelDataHub trata el cuerpo como opaco y lo reenvía a Fideltour sin transformarlo. Consultar la documentación de Fideltour para el esquema de request/response.

Ejemplos¶

Petición (POST)¶

Protocolo: HTTP/1.1 Método: POST Endpoint: <PENDIENTE: dominio público>/api/v1/agent/context/resolve/

Headers:

Content-Type: application/json
Authorization: Token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Body:

{
  "...": "..."
}

Respuestas¶

La respuesta (código de estado y cuerpo) es la que devuelve Fideltour, reenviada sin modificar.

JSON inválido¶

400 Bad Request

{
  "message": "Invalid JSON data"
}

Sin permiso¶

403 Forbidden — el apiuser no tiene asignado el permiso context-agent.

Error de conexión con Fideltour¶

502 Bad Gateway

{
  "message": "Error de conexión con Fideltour"
}