Documentación piloto de la API de Vuelos Rápidos

Acceso anticipado

Esta documentación forma parte de una iniciativa de acceso anticipado sólo para socios seleccionados. Los programas piloto se pondrán en marcha en el cuarto trimestre de 2025, y la disponibilidad general en 2026.

Si estás interesado en convertirte en socio piloto o beta, ponte en contacto con tu gestor de cuentas.

El paquete API Rapid /flights

La API de Vuelos Rápidos se compone de una selección de puntos finales que, juntos, permiten un flujo search-to-book.

a flow diagram showing the path through the Flights API

Conoce los puntos finales de los Vuelos Rápidos

Dado que este producto se encuentra todavía en fase de acceso temprano, ten en cuenta que los detalles del esquema y la funcionalidad están todavía en desarrollo activo y pueden cambiar antes de la publicación completa de este producto a los socios.

Acción	Method	Resto URI	Resultado
Buscar vuelos disponibles	POST	/flight-offers	Devuelve las ofertas disponibles.
Solicitar más detalles sobre ofertas de vuelos	GET	/flight-offers/{offer_id}	Devuelve los detalles de un vuelo, incluyendo el desglose de precios y las políticas.
Solicita un mapa de asientos para el vuelo elegido	GET	/flight-offers/{offer_id}/asientos	Devuelve el mapa de asientos de un vuelo si está disponible.
Proporcionar los detalles del método de pago elegido para la reserva	POST	/pagos	Devuelve un `payment_token`, que va en el cuerpo de la solicitud de creación de reserva.
Reserva completa	POST	/itinerarios/vuelo	Devuelve un ID de itinerario y enlaces para recuperar los detalles de la reserva o completar la sesión de pago.
Solicitar detalles de una reserva existente por ID de itinerario	GET	/itinerarios/{itinerary_id}/flight	Devuelve los detalles del itinerario mediante el parámetro `itinerary_id`.
Cancelación de una reserva	Eliminar	/itinerarios/{itinerary_id}/flight	Cancela una reserva existente.

Caso práctico

A continuación te explicamos cómo puedes utilizar la API de Rapid Flights para crear una experiencia de reserva en end-to-end para tus clientes.

Paso 1 - Buscar ofertas de vuelos disponibles

En primer lugar, utiliza el punto final /flight-offers para que los viajeros puedan ver los vuelos disponibles.

Consulta los parámetros clave a continuación:

Parámetro clave	Descripción	Ejemplo
`departure_airport`	El aeropuerto desde el que sale el vuelo.	LAS
`arrival_airport`	El aeropuerto al que llega el vuelo.	LAX
`departure_date_time`	La hora y la fecha de salida del vuelo.	2025-01-09T17:45:00-08:00

Paso 2 - Proporcionar más detalles sobre las opciones de vuelo disponibles

Antes de mostrar las opciones de vuelo a tu cliente, obtén información más detallada utilizando el punto final /flight-offers/{offer_id}.

Éste es el tipo de detalles que los viajeros deben conocer antes de reservar:

Objeto	Úsalo para...
`amenities`	Muestra las opciones de entretenimiento disponibles en in-flight, como wifi o películas.
`baggage_allowance`	Proporciona detalles sobre cuánto equipaje se incluye con el vuelo.
`change_policy`	Indica si se permiten cambios en post-booking y, en caso afirmativo, si tendrán un coste adicional.
`meal_options`	Qué comida se sirve durante el vuelo y si está incluida o es un cargo adicional.

Paso 3 - Ayuda a tu cliente a elegir su asiento preferido

Utiliza el punto final /flight-offers/{offer_id}/seats para mostrar un mapa de asientos (cuando esté disponible) para que los viajeros puedan elegir su parte preferida del avión.

Ejemplo:

cabin_class: economy
exit_row_list:
  - '17'
  - '18'
rows:
  - row_number: 16
    seats:
      - aisle: false
        column: A
        seat_number: 16A
        availability: not_available
        preferred: false
        seat_codes:
          - window
        seat_token: Q11REWlbQV5VARNfBQBxQ14JXAVYTT1XEwtbXEcJUQpTAkBSR0sNFVUIZgVdFENZSxFqBwtRBlx9eDoSVgNGU0ZCQkFTbFFcRRJbF0BrAllcVAh5dTdDVlwVUURBTRRdbwBXR1JcAVMKAUlRBRUCWG1WDEACdg1XFlByBgRLA1wcBXEDABNwDFJbDRFBDA0BDFkOB1oNVA5Q