購物概覽
「購物 API」可讓您查詢租車供應商的即時價格與空車狀況
簡介
「購物 API」每次請求最多可針對指定地理位置或機場地點,回傳 200 輛車的價格與空車狀況。它支援靈活的取貨與「drop-off」配置,可針對每項服務設定不同的時間與地點。
該回覆包含有關車輛、供應商、地點及費率的資訊,並附有完整的價格明細,以符合 market-specific 的顯示要求。此外,該 API 提供詳盡的車輛資訊,包括乘員容量、行李容量、車門數量及里程數等資料,並附有完整的價格明細,以符合 market-specific 的顯示要求。
定價與付款
「購物 API」提供租賃費用的詳細明細,包括各類租賃費用、費率詳情、總費用、可選附加項目、預 訂時應付金額,以及行銷費。該回覆中亦包含相關政策清單,以及用於辦理付款登記及車輛預訂申請的連結。
可變稅項及費用
總價中可能未包含某些強制性稅費,因為這些費用在預訂時無法計算出來。例如,若歸還車輛時的油量與租賃期間開始時不符,可能會收取加油費用。
佣金 (行銷費用)
佣金 (或稱行銷費) 是指您每筆預訂的預估收益。若您的設定中已啟用 Expedia Affiliate Collect (EAC),請同時設定marketing_fee 和 marketing_fee_eac. 在購物時,您的存取權限並不能完全決定最終預訂是否會使用 EAC,,因此回應中將同時顯示marketing_fee 和marketing_fee_eac。
刪除線價格
如果您想使用刪除線來顯示折扣或特別價格,我們提供兩種選項:
daily_rate_strikethrough: 顯示適用任何折扣前的總價 (不含稅)。此欄位應適用於搜尋結果中通常會顯示不含稅費之基本價格的地區,例如美國。inclusive_strikethrough: 顯示折扣前的總價,已包含稅金及手續費。此欄位旨在讓您更清楚地顯示折扣如何套用至總租金金額。該欄位回傳以計費貨幣和要求貨幣表示的值。
範例
{
"value": [
{
"car_rental_id": "AQ_PvCPCWLLZGzhRf4YeMM1md7xEb41ZEhUz6ns4tIn6Nv-m9LtrUYMhZ4F_a0Xkqu2rGXht4g0Zd53gL4e9yMh0fMVtqe0jKkaZKaBghFVtc",
"vendor": {…},
"locations": {
"pickup": {…},
"dropoff": {…}
},
"description": "Nissan Rogue or similar",
"number_of_passengers": 5,
"number_of_doors": {…},
"acriss_code": "CXMR",
"mileage_tracking": "249 free miles/day",
"fuel_level": "full_to_full",
"road_tax_disclaimer": "road tax applies",
"insurance_coverage": {
"included": {
"collision_damage_waiver": {
"description": "Collision Damage Waiver",
"deductible": {
"billable_currency": {
"value": "1050.00",
"currency": "EUR"
}
},
"trip_rate": {
"billable_currency": {
"value": "0.00",
"currency": "EUR"
}
}
}
},
"supplemental": []
},
"luggage_count": {…},
"image": {…},
"rate": {
"merchant_of_record": "vendor",
"sale_scenario": {…},
"pricing": {
"daily_rate_strikethrough": {…},
"daily_rate": {…},
"totals": {
"inclusive_strikethrough": {
"billable_currency": {
"value": "47.44",
"currency": "USD"
},
"request_currency": {
"value": "47.44",
"currency": "USD"
}
},
"inclusive": {…},
"exclusive": {…},
"fees": {…},
"due_at_booking": {…},
"marketing_fee": {…},
"marketing_fee_eac": {…}
}
}
},
"cancel_penalties": [{…}],
"payment_registration_required": true,
"links": {…}
}
]
}促銷及折扣價格顯示
某些銷售據點在顯示基於促銷活動或「庫存與詳情」回應中提供的劃線價所計算出的折扣總額時,需要標準價格的詳細資訊——即用來計算折扣的價格。請務必確認您計劃開展業務的地區所需提交哪些資訊。
退款選項
請使用「cancel_penalties」欄位,以顯示能為旅客提供價格透明度與更高靈活性的取消選項。請將回應中的「cancel_penalties」部分視為預訂詳情的權威來源。
速率限制
網站流量優化是透過實施速率限制來實現的,藉此確保能持續提供穩定且可維護的服務,同時也保證 Expedia Group 系統能得到有效利用。針對購物 API 的流量,目前會根據一段時間內的總請求量來設定速率限制。
錯誤碼
Rapid 租車 API 與其他 Rapid API 具有相同的錯誤代碼。
API 詳細資料
在這個頁面上探索購物相關端點的定義,然後使用 API Explorer 或其他測試軟體,了解範例和結構描述定義與實際輸出的比較。
其他資源
無論您是想試用所有 Rapid 租車 API 端點,還是想下載其 OpenAPI 規格,我們都能滿足您的需求。