Cómo verificar la disponibilidad de la actividad
Antes de reservar una actividad, debes consultar la disponibilidad para la fecha de viaje deseada y la configuración del viajero. El punto final de disponibilidad devuelve opciones de productos disponibles con precios, horarios e información de recogida.
Punto final
POST {{api_host}}/api/ext/activity/availability
encabezados
| Encabezado | Requerido | Descripción |
|---|---|---|
x-api-key | Sí | Su clave API de Xeni |
Content-Type | Sí | application/json |
Cuerpo de solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
currency | cadena | Sí | Código de moneda para precios (por ejemplo, "USD"). |
paxMix | matriz | Sí | Matriz de grupos de viajeros por franja de edad. |
productCode | cadena | Sí | El código de producto de la actividad de la búsqueda o detalles. |
travelDate | cadena | Sí | La fecha de viaje deseada en formato YYYY-MM-DD. |
Objeto de mezcla de Pax
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
ageBand | cadena | Sí | La categoría de edad de los viajeros (por ejemplo, "ADULT", "CHILD", "INFANT", "SENIOR"). |
numberOfTravelers | entero | Sí | Número de viajeros en este tramo de edad. |
Solicitud de ejemplo
JSON
{
"currency": "USD",
"paxMix": [
{
"ageBand": "ADULT",
"numberOfTravelers": 2
}
],
"productCode": "12345ABC",
"travelDate": "2026-04-15"
}Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
data | matriz | Lista de opciones de productos disponibles. |
data[].productOptionCode | cadena | Código único para esta opción de producto (por ejemplo, "TG1"). Requerido para reservar. |
data[].title | cadena | Nombre de la opción de producto. |
data[].description | cadena | Descripción de lo que incluye esta opción. |
data[].isPickupIncluded | booleano | Si la recogida en el hotel está incluida. |
data[].pricing | objeto | Detalles de precios para esta opción. |
data[].timings | matriz | Horarios de inicio y franjas horarias disponibles. |
data[].lineItems | matriz | Desglose de precios detallados. |
Ejemplo de respuesta
JSON
{
"data": [
{
"productOptionCode": "TG1",
"title": "Standard Tour",
"description": "Guided 3-hour helicopter tour with hotel pickup.",
"isPickupIncluded": true,
"pricing": {
"totalPrice": 450,
"currency": "USD"
},
"timings": [
{
"startTime": "09:00",
"endTime": "12:00"
},
{
"startTime": "14:00",
"endTime": "17:00"
}
],
"lineItems": [
{
"ageBand": "ADULT",
"numberOfTravelers": 2,
"pricePerTraveler": 225,
"subtotal": 450
}
]
}
]
}Notas de uso
- La respuesta puede contener múltiples opciones de productos para la misma actividad. Cada opción representa una variación diferente (por ejemplo, tamaño del grupo, duración o inclusiones).
- Almacene el
productOptionCode(por ejemplo,"TG1") de la opción seleccionada; es obligatorio al crear una reserva. - Si
isPickupIncludedestrue, es posible que tengas que recoger un lugar de recogida del viajero durante el paso de reserva. - Verifique la matriz
timingspara determinar si la actividad requiere una hora de inicio específica. Si hay varios intervalos de tiempo disponibles, preséntelos al usuario para que los seleccione. - La disponibilidad y los precios son en tiempo real. Siempre verifique la disponibilidad inmediatamente antes de continuar con el paso de reserva.
Próximos pasos
¿Listo para reservar? Consulte Cómo reservar una actividad.