予約概要

旅行者のフライト予約作成

Booking APIの主な機能は、選択したフライトオファーの予約を作成することです。予約が作成される前に、旅行者の支払いに関する詳細を支払い登録エンドポイント(POST /v2/payments)に送信し、.NET Frameworkを取得する必要があります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"
        }
    }
}