Documentação piloto da API de voos rápidos

Prévia de acesso antecipado

Esta documentação faz parte de uma iniciativa de pré-visualização de acesso antecipado somente para parceiros selecionados. Os programas piloto serão lançados no quarto trimestre de 2025, com disponibilidade geral em 2026.

Se você estiver interessado em se tornar um parceiro piloto ou beta, entre em contato com seu gerente de conta.

O pacote de API Rapid /flights

A API Rapid Flights é composta por uma seleção de endpoints que juntos permitem um fluxo search-to-book.

a flow diagram showing the path through the Flights API

Conheça os pontos finais do Rapid Flights

Como este produto ainda está na fase de acesso inicial, tenha em mente que os detalhes do esquema e a funcionalidade ainda estão em desenvolvimento ativo e podem mudar antes do lançamento completo deste produto para parceiros.

Ação	Método	URI de descanso	Resultado
Pesquisar voos disponíveis	POST	/flight-offers	Retorna ofertas disponíveis.
Solicite mais detalhes sobre ofertas de voos	GET	/flight-offers/{offer_id}	Retorna os detalhes de um voo, incluindo detalhamento de preços e políticas.
Solicite um mapa de assentos para o voo escolhido	GET	/flight-offers/{offer_id}/assentos	Retorna o mapa de assentos de um voo, se estiver disponível.
Forneça detalhes do método de pagamento escolhido para a reserva	POST	/pagamentos	Retorna um `payment_token`, que vai no corpo da solicitação de criação de reserva.
Reserva completa	POST	/itinerários/voo	Retorna um ID de itinerário e links para recuperar detalhes da reserva ou concluir a sessão de pagamento.
Solicitar detalhes de uma reserva existente por ID do itinerário	GET	/itinerários/{itinerary_id}/voo	Retorna detalhes do itinerário pelo parâmetro `itinerary_id`.
Cancelar uma reserva	EXCLUIR	/itinerários/{itinerary_id}/voo	Cancela uma reserva existente.

Caso de uso

Veja como você pode usar a API Rapid Flights para criar uma experiência de reserva end-to-end para seus clientes.

Etapa 1 - Pesquise ofertas de voos disponíveis

Primeiro, use o ponto de extremidade /flight-offers para permitir que os viajantes vejam quais voos estão disponíveis.

Confira os principais parâmetros abaixo:

Parâmetro chave	Descrição	Exemplo
`departure_airport`	O aeroporto de onde o voo parte.	LAS
`arrival_airport`	O aeroporto onde o voo chega.	LAX
`departure_date_time`	A hora e a data de partida do voo.	2025-01-09T17:45:00-08:00

Etapa 2 - Forneça mais detalhes sobre as opções de voo disponíveis

Antes de apresentar opções de voo ao seu cliente, obtenha informações mais detalhadas usando o ponto de extremidade /flight-offers/{offer_id}.

Aqui estão os tipos de detalhes que os viajantes precisam saber antes de reservar:

Objeto	Use-o para...
`amenities`	Exibir opções de entretenimento disponíveis in-flight, como WiFi ou filmes.
`baggage_allowance`	Forneça detalhes sobre a quantidade de mala incluída no voo.
`change_policy`	Indique se alterações em post-booking são permitidas e, em caso afirmativo, se elas incorrerão em uma taxa adicional.
`meal_options`	Que tipo de comida é servida durante o voo e se ela está incluída ou é um custo adicional.

Etapa 3 - Ajude seu cliente a escolher seu assento preferido

Use o ponto de extremidade /flight-offers/{offer_id}/seats para exibir um mapa de assentos (quando disponível) para que os viajantes possam escolher sua parte preferida do avião.

Exemplo:

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