預訂概覽

「預訂 API」讓旅客能夠預訂租車服務

當旅客透過「購物 API」選定供應商和車輛後，您將提供他們「預訂 API」以完成預訂。預訂 API 的主要功能是針對所選的車輛方案建立預訂。

Expedia Collect 預付

對於 Expedia Collect 的預訂，在完成預訂之前，必須將付款資訊傳送至我們的付款註冊端點 (v2/payments)，該端點將產生一個安全的payment_token，此連結須用於「建立預訂」請求的請求正文中。接著，您需傳入必填的「affiliate_reference_id」、主要駕駛人資訊以及付款代碼，以建立預訂。

注意：對於 Expedia Collect 的預訂，空房狀況與詳細資訊回應中的「payment_registration_required」欄位將始終顯示為 true，且「payment_token」將包含在「Create Booking」請求中。

供應商代收

對於「供應商代收」流程，會使用「可用性與詳細資訊」回應中的「payment_registration_required」欄位，來判斷建立預訂時是否需要付款憑證。

當使用 payment_registration_required=true` ` 進行詳細回覆時，付款註冊是強制性的，且必須在 `Create Booking` 請求中包含 payment_token 。
當payment_registration_required=false 在詳細回應中，付款註冊為可選項目，且「預訂確認碼」（payment_token）可能會或可能不會包含在「建立預訂」請求中。

>> 了解 Payments API

建立預訂

每則成功的預訂回覆中，皆包含用以查詢行程的連結。建立預訂的連結將持續有效，直到該供應商針對該carOfferToken 的庫存已用完為止。

範例請求

POST https://api.ean.com/v2/itineraries/car
	?token=U1dFC0JHTWxUCwUHCWNjQ1sQRxBVVwFAW... ...15YTQTcHhefjYOfiBQfThuP1hcfVULeAM0W0U6VWBZFzQXdltcUFwRQgkLCgBRAAEHAVEADg==
{
  "affiliate_reference_id": "4480ABC",
  "primary_driver": {
    "given_name": "{{first_name}}",
    "middle_name": "Test",
    "family_name": "{{last_name}}",
    "phone": {
      "country_code": "1",
      "area_code": "487",
      "number": "5550077"
    },
    "email": "{{email}}"
  },
  "flight_details": {
      "air_carrier_code": "G4",
      "flight_number": 778
  },
  "traveler_loyalty_member_id": "ABCD1234","
  "requested_extras": [
    "SatelliteRadio",
    "ToddlerChildSeat"
  ],
  "affiliate_metadata": "data_point_1:123|data_point2:This is data.",
  "payment_token": "{{payment_token}}"
}

範例回應

{
    "itinerary_id": "9030336886597",
    "links": {
        "retrieve": {
            "method": "GET",
            "href": "https://api.ean.com/v2/itineraries/9030336886597/car",
        }
    }
}

>> 進一步了解預訂管理 >> 了解如何處理預訂請求

若要進行不會從您的信用卡扣款，也不會發送給供應商的測試預訂，請參閱我們的測試請求文件。

API 詳細資料

在這個頁面上探索預訂相關端點的定義，然後使用 API Explorer 或其他測試軟體，了解範例和結構描述定義與實際輸出的比較。

其他資源

無論您是想試用 Rapid Car API 的所有端點，還是想下載其 OpenAPI 規格文件，我們都能滿足您的需求。