Primeros pasos con la API de actividades de XeniCómo reservar una actividadCómo buscar etiquetas y categorías de actividadesCómo cancelar una reserva de actividadCómo comprobar la disponibilidad de la actividadCómo obtener detalles de la actividadCómo recuperar los detalles de la reserva de actividadesCómo buscar actividades con filtrosCómo buscar destinos de actividadesAPI de alquiler de coches: introducciónAPI de alquiler de coches: comprensión de los campos de respuestaCómo reservar un alquiler de cochesCómo obtener detalles del vehículo de alquiler y complementos de equipoCómo recuperar o cancelar una reserva de alquiler de cochesCómo buscar autos de alquiler disponiblesCómo buscar ubicaciones de recogidaCómo utilizar los filtros de búsqueda de alquiler de cochesMejores prácticas de integración de API de ofertasPreguntas frecuentes sobre la API de ofertasPrimeros pasos con la API de ofertas de XeniReferencia de encabezados y parámetros de solicitud de API de ofertasOfertas API Monedas admitidas y localizaciónCómo mostrar ofertas en su aplicaciónCómo buscar ofertas de hoteles por ubicaciónCódigos de error de la API de vuelos y solución de problemasPrimeros pasos con la API de vuelos de XeniCómo reservar un vueloCómo comprobar la disponibilidad y el precio de los vuelosCómo confirmar o cancelar una reserva de vueloCómo recuperar las reglas de tarifas de un vueloCómo recuperar los detalles de la reserva de un vueloCómo buscar aeropuertos usando AutocompletarCómo buscar vuelosCómo utilizar filtros, clasificación y paginación de búsqueda de vuelosCómo comprobar la disponibilidad y el precio de las habitacionesCómo filtrar los resultados de los alquileres vacacionalesCómo obtener detalles, comodidades y accesibilidad de la propiedad del resortCómo mantener y confirmar una reserva de resortCómo liberar una retención de resortCómo recuperar los detalles de la reserva del resortCómo buscar complejos turísticos disponiblesCómo buscar destinos turísticosCómo buscar ubicaciones de alquiler vacacionalCómo buscar alquileres vacacionalesCómo utilizar filtros de búsqueda y clasificación de complejos turísticosComenzando con la API de Xeni ResortsAPI de Resorts: comprensión de los estados y políticas de las reservasPrimeros pasos con la API de alquileres vacacionalesPreguntas frecuentes sobre alquileres vacacionalesTipos de propiedades admitidas para alquileres vacacionalesComprensión de la búsqueda asincrónica para alquileres vacacionalesAutenticación y firmas APIReserva de hoteles: API directa y pago SSOManejo de errores, límites de tasas y mejores prácticasPrimeros pasos con la API de Xeni HotelesGestión de reservas: estado, recuperación y cancelaciónConfirmación de precios y ciclo de vida del tokenRecuperar detalles del hotel y disponibilidad de habitacionesBúsqueda de hoteles: ubicaciones, filtros y paginaciónBuscando HotelesGestión de sesiones e ID de correlaciónAutenticación API y obtención de claves API

Referencia de encabezados y parámetros de solicitud de API de ofertas

Última actualización: 2026-03-03

Referencia de encabezados y parámetros de solicitud de API de ofertas

Este artículo proporciona una referencia detallada para cada parámetro de consulta y encabezado HTTP aceptado por el punto final de la API de ofertas. Comprender cada campo le ayuda a crear solicitudes precisas y obtener los resultados más relevantes.

Parámetros de consulta

lat (obligatorio)

  • Tipo: flotante
  • Ejemplo: 34.0522
La latitud de la ubicación para buscar ofertas. Los valores oscilan entre -90.0 (Polo Sur) y 90.0 (Polo Norte). La API utiliza esta coordenada, junto con long, para determinar qué ofertas de hotel devolver según la proximidad.

Utilice al menos cuatro decimales para obtener resultados precisos. Cuatro decimales proporcionan una precisión de aproximadamente 11 metros, lo que es más que suficiente para buscar ofertas.

lat=48.8566    ← Paris, France
lat=35.6762    ← Tokyo, Japan
lat=-33.8688   ← Sydney, Australia

long (obligatorio)

  • Tipo: flotante
  • Ejemplo: -118.2437
La longitud de la ubicación para buscar ofertas. Los valores oscilan entre -180.0 (oeste) y 180.0 (este). 
long=2.3522     ← Paris, France
long=139.6503   ← Tokyo, Japan
long=151.2093   ← Sydney, Australia

currency (obligatorio)

  • Tipo: cadena
  • Ejemplo: USD
Un código de moneda de tres letras ISO 4217. Todos los precios de las ofertas en la respuesta se convertirán y se mostrarán en esta moneda. Los valores comunes incluyen:
CódigoMoneda
USDDólar estadounidense
EUReuros
GBPLibra esterlina británica
CADDólar canadiense
AUDDólar australiano
MXNpeso mexicano
JPYYen japonés
BRLReal brasileño
Consulte Monedas admitidas y localización para obtener la lista completa y detalles sobre cómo funciona la conversión de moneda.

top_destination (opcional)

  • Tipo: booleano
  • Predeterminado: false
  • Ejemplo: true
Cuando se establece en true, la API devuelve ofertas para destinos de viaje populares cerca de las coordenadas proporcionadas en lugar de las propiedades estrictamente más cercanas. Esto es útil para crear secciones de "Destinos principales" o "Ofertas de tendencia" donde desea resaltar ubicaciones conocidas en lugar del hotel disponible más cercano.

Cuando se omite o se establece en false, la API devuelve ofertas basadas únicamente en la proximidad a las coordenadas dadas.

# Proximity-based deals (default)
?lat=40.7128&long=-74.0060&currency=USD

Top destination deals

?lat=40.7128&long=-74.0060&currency=USD&top_destination=true

encabezados HTTP

accept (obligatorio)

  • Valor: application/json
Especifica que el cliente espera una respuesta JSON. Establezca siempre esto en application/json.

accept-language (recomendado)

  • Valor: Etiqueta de idioma (p. ej., en, es, fr, de)
  • Comportamiento predeterminado: en si se omite
Controla el idioma utilizado para el contenido localizado en la respuesta, como nombres de propiedades, descripciones y etiquetas de acuerdos. Utilice una etiqueta de idioma estándar BCP 47. 
accept-language: en       ← English
accept-language: es       ← Spanish
accept-language: fr       ← French
accept-language: de       ← German
accept-language: pt-BR    ← Brazilian Portuguese

origin (recomendado)

  • Valor: La URL de origen de tu aplicación
  • Ejemplo: https://yourdomain.com
El origen de la solicitud solicitante. Si bien no es estrictamente necesario para que la solicitud se realice correctamente, se recomienda incluir este encabezado para el manejo adecuado de CORS y la atribución de la solicitud.

referer (recomendado)

  • Valor: La URL completa de la página que realiza la solicitud.
  • Ejemplo: https://yourdomain.com/deals
La URL de la página de referencia. Al igual que origin, esto ayuda en el seguimiento y análisis de solicitudes.

timezone (recomendado)

  • Valor: Identificador de zona horaria de la IANA
  • Ejemplo: America/Los_Angeles
La zona horaria del usuario. Esto permite que la API devuelva información de la oferta relevante para el tiempo, como las horas de vencimiento de la oferta o las ventanas de registro, ajustadas a la hora local del usuario. Utilice una cadena de zona horaria de IANA válida.

Valores comunes de zona horaria:

Zona horariaRegión
America/NewYorkEste de EE. UU.
America/ChicagoCentro de EE. UU.
America/DenverMontaña de EE. UU.
America/LosAngelesPacífico de EE. UU.
Europe/LondonReino Unido
Europe/ParisEuropa Central
Asia/TokyoJapón
Australia/SydneyAustralia Oriental

Puede detectar la zona horaria del usuario mediante programación en JavaScript:
JAVASCRIPT
const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
// e.g., "America/Los_Angeles"

x-correlation-id (obligatorio)

  • Valor: UUID v4
  • Ejemplo: 550e8400-e29b-41d4-a716-446655440000
Un identificador único para la solicitud individual. Esto se utiliza para el seguimiento distribuido y la depuración. Genere un nuevo UUID para cada llamada API.
JAVASCRIPT
const correlationId = crypto.randomUUID();

Si necesita comunicarse con el soporte de Xeni sobre una solicitud específica, proporcione el valor x-correlation-id para que el equipo pueda rastrearlo a través del sistema.

x-session-id (obligatorio)

  • Valor: UUID v4
  • Ejemplo: 6fa459ea-ee8a-3ca4-894e-db77e160355e
Un identificador de sesión que agrupa solicitudes relacionadas de la misma sesión de usuario. A diferencia de x-correlation-id, que cambia según la solicitud, x-session-id debe permanecer igual durante una única sesión de usuario.

Esto ayuda a la API a optimizar los resultados y permite a Xeni realizar un seguimiento de los viajes de los usuarios con fines analíticos.

JAVASCRIPT
// Generate once per session and reuse
if (!sessionStorage.getItem('xeniSessionId')) {
  sessionStorage.setItem('xeniSessionId', crypto.randomUUID());
}
const sessionId = sessionStorage.getItem('xeniSessionId');

Ejemplo de solicitud completa

Juntando todos los parámetros y encabezados:

BASH
curl -X GET "https://travelapi.ai/hotels/api/v2/deals?lat=51.5074&long=-0.1278&currency=GBP&top_destination=true" \
  -H "accept: application/json" \
  -H "accept-language: en" \
  -H "origin: https://myapp.com" \
  -H "referer: https://myapp.com/travel-deals" \
  -H "timezone: Europe/London" \
  -H "x-correlation-id: d290f1ee-6c54-4b01-90e6-d701748f0851" \
  -H "x-session-id: 7c9e6679-7425-40de-944b-e07fc1f90ae7"

¿Te resultó útil este artículo?