Primeros pasos con la API de ofertas de Xeni
La API de Xeni Deals brinda acceso en tiempo real a descuentos y promociones de hoteles de múltiples proveedores en todo el mundo. A diferencia de una búsqueda de hotel tradicional donde los usuarios especifican fechas y destinos, la API de ofertas muestra ofertas basadas en la ubicación, mostrando a los viajeros las mejores ofertas de hoteles disponibles cerca de su posición actual o cualquier conjunto de coordenadas.
Qué hace la API de ofertas
La API de ofertas tiene un propósito único y específico: devolver ofertas de hoteles cerca de una ubicación geográfica. Esto lo hace ideal para:
- Widgets de ofertas de la página de inicio: muestre a los visitantes ofertas de hoteles atractivas basadas en su ubicación actual tan pronto como lleguen a su sitio.
- Descubrimiento de aplicaciones móviles: busque ofertas de hoteles cercanos utilizando las coordenadas GPS del dispositivo.
- Marketing de destinos: muestra ofertas seleccionadas para los principales destinos para inspirar la planificación de viajes.
- Flujos de reserva de última hora: presente opciones de hotel con descuento a los viajeros que ya se encuentran en un destino o cerca de él.
Las ofertas se agregan de varios proveedores de hoteles, por lo que una sola llamada API puede generar descuentos de una amplia gama de propiedades y marcas.
URL base
Todas las solicitudes de la API de ofertas se realizan en la siguiente URL base:
https://travelapi.ai/hotels/api/v2/deals
El punto final
La API de ofertas expone un único punto final GET:
GET /hotels/api/v2/deals
Usted proporciona una latitud, longitud y moneda, y la API devuelve ofertas de hoteles disponibles cerca de esa ubicación con precios en su moneda especificada.
Requisitos previos
Antes de comenzar, asegúrese de tener:
- Credenciales de API: su clave y secreto de API, proporcionados durante la incorporación. Se utilizan para generar encabezados de autenticación.
- Coordenadas geográficas: un par de latitud y longitud para la ubicación que desea consultar.
- Código de moneda: un código de moneda ISO 4217 (por ejemplo,
USD,EUR,GBP) para precios de oferta.
Si aún no ha recibido sus credenciales API, comuníquese con su representante de cuenta Xeni.
Inicio rápido
Esta es la forma más rápida de recuperar ofertas de hoteles. Este ejemplo busca ofertas cerca de Los Ángeles en dólares estadounidenses:
curl -X GET "https://travelapi.ai/hotels/api/v2/deals?lat=34.0522&long=-118.2437¤cy=USD" \
-H "accept: application/json" \
-H "accept-language: en" \
-H "timezone: America/Los_Angeles" \
-H "x-correlation-id: 550e8400-e29b-41d4-a716-446655440000" \
-H "x-session-id: 6fa459ea-ee8a-3ca4-894e-db77e160355e"
La respuesta contiene una variedad de ofertas de hoteles con detalles de propiedades, precios e información de descuentos para hoteles cerca de las coordenadas proporcionadas.
Cómo funcionan las ofertas
Las ofertas devueltas por la API son dinámicas y urgentes. Las características clave incluyen:
- Basado en la ubicación: las ofertas se dirigen a propiedades cercanas a la latitud y longitud que usted proporciona. La API determina automáticamente un radio de búsqueda apropiado.
- Precios en tiempo real: los precios y la disponibilidad reflejan los datos actuales de los proveedores. Las ofertas pueden aparecer o desaparecer a medida que cambia el inventario.
- Multiproveedor: los resultados se agregan en toda la red de proveedores de Xeni, para que pueda obtener una visión amplia de los descuentos disponibles sin administrar múltiples integraciones.
- Según la moneda: los precios se devuelven en la moneda que usted especifique y la conversión se realiza en el lado del servidor.
Próximos pasos
- Cómo obtener ofertas de hotel por ubicación: descripción detallada del punto final con un ejemplo de solicitud completo.
- Parámetros y encabezados de solicitud: referencia completa para todos los parámetros de consulta y encabezados requeridos.
- Mejores prácticas para la integración: orientación sobre almacenamiento en caché, sondeo y manejo de errores.