預訂概覽

為旅客建立航班預訂

預訂 API 的主要功能是為所選航班優惠建立預訂。在建立預訂前，旅客的付款詳細資訊應傳送至付款註冊端點 (POST /v2/payments)，以取得 payment_token. 接著可透過POST 呼叫/v1/itineraries/flight，並傳入包含以下內容的CreateItineraryRequest 主體：payment_token（旅行者資訊）、affiliate_reference_id（所需的associated_user 物件）。

建立預約

每筆成功的預訂回覆皆包含行程單編號及可供檢索行程單的連結。創建預訂的連結將持續有效，直至航空公司的優惠到期為止。

樣本請求

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