예약 개요

여행자를 위한 항공권 예약 생성

예약 API의 주요 기능은 선택한 항공편 오퍼에 대한 예약을 생성하는 것입니다. 예약이 생성되기 전에 여행자의 결제 세부 정보를 결제 등록 엔드포인트(POST /v2/payments)로 전송하여 payment_token. 그런 다음 POST, 여행자 정보, /v1/itineraries/flight, 필수 CreateItineraryRequest 객체를 포함하는 payment_token 본문으로 affiliate_reference_id 으로 associated_user 호출할 수 있습니다.

예약 만들기

각 예약 성공 응답에는 일정 ID와 일정를 검색할 수 있는 링크가 포함되어 있습니다. 예약을 생성하는 링크는 항공사의 혜택이 만료될 때까지 유효합니다.

샘플 요청

{
  "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"

샘플 응답

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