Preguntas frecuentes sobre la API de ofertas

Este artículo responde a las preguntas más comunes sobre la API de Xeni Deals, desde cómo se obtienen las ofertas hasta cómo completar una reserva.

¿Con qué frecuencia se actualizan las ofertas?

Las ofertas se obtienen en tiempo real de múltiples proveedores de hoteles. Cada vez que llama al punto final, la API consulta el inventario de proveedores actual y devuelve las últimas ofertas disponibles. Esto significa que el conjunto de ofertas que recibe puede cambiar de una solicitud a la siguiente a medida que los proveedores agregan, modifican o eliminan promociones.

En la práctica, las ofertas para una ubicación determinada tienden a ser relativamente estables durante períodos cortos (minutos), pero pueden cambiar significativamente en el transcurso de horas a medida que cambian los precios y la disponibilidad de los proveedores. Recomendamos actualizar los datos de las ofertas cada 5 a 10 minutos si muestra ofertas en una página de larga duración.

¿Puedo filtrar ofertas por clasificación de estrellas del hotel?

Actualmente, la API de ofertas no admite el filtrado del lado del servidor por clasificación de estrellas. El punto final devuelve todas las ofertas disponibles cerca de la ubicación especificada.

Sin embargo, la respuesta incluye información de calificación de estrellas para cada propiedad, por lo que puede filtrar del lado del cliente:

// Filter for 4-star and above
const premiumDeals = deals.filter(deal => deal.star_rating >= 4);

Este enfoque le brinda control total sobre la lógica de filtrado y le permite ofrecer a los usuarios controles de filtro interactivos sin llamadas API adicionales.

¿Cómo reservo una oferta?

La API de ofertas es un punto final de descubrimiento: muestra las ofertas disponibles pero no maneja las reservas directamente. Para reservar un hotel a partir de una oferta, utiliza la API de Xeni Hotels:

1. Capture el ID de propiedad de la oferta que seleccione el usuario.
2. Verifique la disponibilidad llamando al punto final de disponibilidad de la API de hoteles con el ID de la propiedad, las fechas deseadas y el número de huéspedes.
3. Confirmar precios utilizando el punto final de confirmación de precios de la API de Hoteles para fijar la tarifa.
4. Cree la reserva a través del punto final de reserva de la API de Hoteles.

Para obtener más detalles, consulte la documentación de la API de hoteles.

¿Cuál es la diferencia entre ofertas y una búsqueda de hotel normal?

¿Puedo obtener ofertas para una fecha futura?

La API de ofertas no acepta parámetros de fecha de entrada o salida. Devuelve ofertas promocionales actualmente disponibles para propiedades cerca de la ubicación especificada. Estas ofertas pueden incluir períodos de viaje (intervalos de fechas durante los cuales la oferta es válida), pero no puede consultar ofertas en una fecha futura específica.

Si necesita encontrar disponibilidad y precios de hoteles para fechas específicas, utilice los puntos finales de búsqueda y disponibilidad de la API de hoteles.

¿Qué hace el parámetro top_destination?

Cuando top_destination se establece en true, la API ajusta su comportamiento para devolver ofertas para destinos de viaje populares y conocidos cerca de las coordenadas proporcionadas en lugar de los hoteles estrictamente más cercanos.

Por ejemplo, si pasa las coordenadas de un área suburbana fuera de Miami con topdestination=false (u omite el parámetro), es posible que obtenga ofertas para hoteles suburbanos cercanos. Con topdestination=true, la API puede generar ofertas para hoteles populares de Miami Beach u otros destinos conocidos de la región.

Esto es útil para:- Secciones "Destinos de tendencia": resalta ubicaciones populares con ofertas activas.

• UI centradas en la inspiración: muestra destinos aspiracionales para fomentar la navegación.
• Visualizaciones alternativas: cuando una búsqueda de proximidad arroja pocos resultados, una consulta del destino principal puede llenar la página con opciones atractivas.

# Proximity-based (default behavior)
GET /hotels/api/v2/deals?lat=25.95&long=-80.15&currency=USD

Top destinations near this area
GET /hotels/api/v2/deals?lat=25.95&long=-80.15&currency=USD&top_destination=true

¿Qué monedas se admiten?

La API admite la mayoría de los códigos de moneda ISO 4217, incluidos USD, EUR, GBP, CAD, AUD, MXN, JPY, BRL, INR y muchos más. Consulte Monedas admitidas y localización para obtener la lista completa y detalles sobre cómo funciona la conversión de moneda.

¿Qué pasa si no hay ofertas para mi ubicación?

Si actualmente no hay ofertas disponibles cerca de las coordenadas proporcionadas, la API devuelve una respuesta exitosa con una matriz de ofertas vacía. Esto no es un error.

Para manejar esto con gracia:

• Muestra un mensaje amigable como "No hay ofertas disponibles cerca en este momento".
• Oferta para mostrar ofertas para una ubicación diferente.
• Recurrir a una solicitud top_destination=true para mostrar ofertas populares en la región más amplia.
• Anime al usuario a volver a consultar más tarde, ya que las ofertas se actualizan con frecuencia.

¿Qué tamaño tiene el radio de búsqueda?

La API determina el radio de búsqueda automáticamente en función de la densidad de ofertas disponibles cerca de las coordenadas proporcionadas. En áreas con muchas propiedades hoteleras (como las grandes ciudades), el radio puede ser más reducido. En áreas menos densas, el radio puede expandirse para garantizar que se obtengan resultados útiles.

No es necesario especificar un radio; la API lo optimiza por usted.

¿Necesito autenticación para usar la API de ofertas?

Sí. Como todas las API de Xeni, la API de ofertas requiere credenciales de API válidas. Necesitará su clave API y su secreto, que se proporcionan durante la incorporación. Las solicitudes sin autenticación válida recibirán una respuesta 401 no autorizada.

Consulte la Documentación de autenticación para obtener detalles sobre cómo generar firmas de autenticación.

¿Puedo utilizar la API de ofertas para ofertas no hoteleras?

No. La API de ofertas es específicamente para ofertas de hoteles. No devuelve ofertas de vuelos, alquiler de automóviles, actividades u otros productos de viaje. Para ello, consulte las respectivas colecciones de API en la documentación de API de Xeni.

¿A quién debo contactar para obtener asistencia?

Si tiene preguntas sobre la API de ofertas o necesita ayuda con su integración, comuníquese con el soporte de Xeni al customersupport@xeni.com. Al informar un problema, incluya el x-correlation-id de la solicitud problemática para ayudar al equipo de soporte a investigar rápidamente.