預訂概覽
「預訂 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)可能會或可能不會包含在「建立預訂」請求中。
建立預訂
每則成功的預訂回覆中,皆包含用以查詢行程的連結。建立預訂的連結將持續有效,直到該供應商針對該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 規格文件,我們都能滿足您的需求。