Visão geral da reserva

Crie reservas de voos para viajantes.

A função principal da API de Reservas é criar uma reserva para a oferta de voo selecionada. Antes de uma reserva ser criada, os detalhes de pagamento do viajante devem ser enviados para o endpoint de registro de pagamento (POST /v2/payments) para obter um payment_token. Uma chamada POST para /v1/itineraries/flight pode então ser feita com um corpo CreateItineraryRequest que inclui o payment_token, informações do viajante, affiliate_reference_id e o objeto associated_user necessário.

Criar uma reserva

Cada confirmação de reserva bem-sucedida contém um ID de itinerário e links para acessar o itinerário. O link para efetuar a reserva permanecerá válido até o término da oferta da companhia aérea.

Exemplo de solicitação

{
  "affiliate_reference_id": "test_book",
  "hold": false,
  "payment_token": "string",
  "primary_traveler": {
    "name": {
      "given_name": "John",
      "middle_name": "Micheal",
      "last_name": "Smith"
    },
    "date_of_birth": "11-03-200",
    "gender": "male",
    "email": "email@gmail.com",
    "phone": {
      "country_code": "1",
      "area_code": "134",
      "number": "8931"
    },
    "traveler_type": "adult",
    "passport": {
      "number": "A12345678",
      "expiration_code": "11-12-2027",
      "country_code": "US"
    },
    "frequent_flyer_programs": [
      {
        "marketing_carrier_code": "AA",
        "program_carrier_code": "AA",
        "number": "92817283"
      }
    ],
    "tsa_number": "981234567",
    "redress_number": "213421",
    "special_assistance": "deaf",
    "seat_tokens": [
      "Q11REWlbQV5VARNfBXcWA1QMUgpEZgxMCwRcSwgGUgBWFwdBR1ASAlg7WA1GFlxETTpWCwBQXjJ9ekRQVxZXQEBDRVZpUllHRw1GEWtXDlJdDHl0Z0IBV0kEQkJASgNnVAVCVgpTA1EMGVVTGQkDNQhfEFZwAwxAACIDBhlWC0EKdwADFnZbAVRTFRdZXAMDCFkNAFQAWA0=",
      "Q11REWlbQV5VARNfBXQWA1QMUgpEZgxMCwRcSwgGUgBWFwdBR1ASAlg7WA1GFlxETTpWCwBQXjJ9ekRQVxZXQEBDRVZpUllHRw1GEWtXDlJdDHl0Z0IBV0kEQkJASgNnVAVCVgpTA1EMGVVTGQkDNQhfEFZwAwxAACIDBhlWC0EKdwADFnZbAVRTFRdZXAMLDVgNCFQKVwA="
    ]
  },
  "additional_travelers": [
    {
      "name": {
        "given_name": "John",
        "middle_name": "Micheal",
        "last_name": "Smith"
      },
      "date_of_birth": "01-02-1999",
      "gender": "male",
      "email": "gmail@gmail.com",
      "phone": {
        "country_code": "1",
        "area_code": "134",
        "number": "8931"
      },
      "traveler_type": "adult",
      "passport": {
        "number": "A12345678",
        "expiration_code": "11-12-2027",
        "country_code": "US"
      },
      "frequent_flyer_programs": {
        "marketing_carrier_code": "AA",
        "program_carrier_code": "AA",
        "number": "92817283"
      },
      "tsa_number": "981234567",
      "redress_number": "213421",
      "special_assistance": "deaf",
      "seat_tokens": [
        "Q11REWlbQV5VARNfBXcWA1QMUgpEZgxMCwRcSwgGUgBWFwdBR1ASAlg7WA1GFlxETTpWCwBQXjJ9ekRQVxZXQEBDRVZpUllHRw1GEWtXDlJdDHl0Z0IBV0kEQkJASgNnVAVCVgpTA1EMGVVTGQkDNQhfEFZwAwxAACIDBhlWC0EKdwADFnZbAVRTFRdZXAMDCFkNAFQAWA0=",
        "Q11REWlbQV5VARNfBXQWA1QMUgpEZgxMCwRcSwgGUgBWFwdBR1ASAlg7WA1GFlxETTpWCwBQXjJ9ekRQVxZXQEBDRVZpUllHRw1GEWtXDlJdDHl0Z0IBV0kEQkJASgNnVAVCVgpTA1EMGVVTGQkDNQhfEFZwAwxAACIDBhlWC0EKdwADFnZbAVRTFRdZXAMLDVgNCFQKVwA="
      ]
    }
  ],
  "associated_user": {
    "email": "gmail@gmail.com",
    "phone": {
      "country_code": "1",
      "area_code": "134",
      "number": "8931"
    }
  },
  "affiliate_metadata": "displayName:red | realName:blue",
  "tax_registration_number": "CFZPK7190K"

Exemplo de resposta

{
    "itinerary_id": "8999989898988",
    "links": {
        "retrieve": {
            "method: "GET",
            "href": "/v1/itineraries/flight/8999989898988?token=valid_token"
        }
    }
}