Comenzando con la API de Vuelos de Xeni

La API v2 de Xeni Flights proporciona acceso programático al inventario de vuelos global. Puede buscar aeropuertos, consultar vuelos disponibles, verificar disponibilidad y reglas de tarifas, y completar reservas completamente a través de API.

Qué puedes hacer

La API de vuelos admite el ciclo de vida completo de la reserva:

• Buscar aeropuertos: utilice la función de autocompletar para resolver nombres de aeropuertos o códigos IATA en datos estructurados de aeropuertos.
• Buscar vuelos: consulte vuelos disponibles por ruta, fechas, número de pasajeros, clase de cabina y aplique filtros para escalas, aerolíneas, horarios de salida y más.
• Ver disponibilidad: obtenga segmentos de vuelo detallados, precios en tiempo real y requisitos de pasaporte para una cabina seleccionada.
• Ver reglas de tarifas: inspeccione las políticas de cancelación y cambio, incluidos los detalles de multas estructuradas por tipo de pasajero.
• Crear reservas: envíe información del viajero, detalles del pasaporte y servicios adicionales opcionales para reservar un vuelo.
• Administrar reservas: confirme, cancele o recupere los detalles de la reserva mediante el ID de la reserva.

URL base

Todos los puntos finales de Flights API v2 utilizan la siguiente ruta base:

{{api_host}}/flights/api/v2/...

Reemplace {{api_host}} con el host específico de su entorno (UAT o producción), proporcionado durante la incorporación.

Autenticación

Cada solicitud a la API de vuelos requiere el siguiente encabezado:

El flujo de reservas

La API de vuelos utiliza un patrón de encadenamiento de tokens. Cada paso del flujo produce un token o ID que se requiere en el siguiente paso.

1. Autocomplete
   └── Captures x-correlation-id from response headers
Search
   └── Returns cabinsearchsession_id (per cabin option)
Availability
   └── Returns cabinavailabilitytoken
Fare Rules (optional)
   └── Uses cabinavailabilitytoken
Create Booking
   └── Uses cabinavailabilitytoken
   └── Returns booking_id
Confirm / Cancel / Get Booking
   └── Uses booking_id

Resumen paso a paso

1. Autocompletar: resuelve nombres o códigos de aeropuertos. Capture el x-correlation-id de los encabezados de respuesta para usarlo en solicitudes posteriores.
2. Buscar: envíe origen, destino, fechas, pasajeros y tipo de cabina. La respuesta incluye opciones de vuelo, cada una con una o más entradas de cabina que contienen un cabinsearchsession_id.
3. Disponibilidad: pase un cabinsearchsessionid para obtener información detallada del segmento, el precio final y un cabinavailability_token.
4. Reglas de tarifas: pase el cabinavailabilitytoken para consultar las políticas de cancelación y cambio antes de reservar.
5. Crear reserva: envíe el cabinavailabilitytoken junto con los detalles del viajero para crear una reserva. La respuesta incluye un booking_id.
6. Confirmar o cancelar: utilice booking_id para confirmar la reserva (emitir boletos) o cancelarla.

Puntos finales API de un vistazo

Próximos pasos

• Cómo buscar aeropuertos mediante Autocompletar: comience resolviendo los códigos de aeropuerto.
• Cómo buscar vuelos: aprenda cómo consultar vuelos disponibles.
• Códigos de error y solución de problemas de la API de vuelos: referencia para el manejo de errores en todos los puntos finales.