Rapid Car API 概覽
啟用穩健的 end-to-end 租車預訂服務
Car API 套件
Rapid Car API 透過 Expedia Group's 提供的豐富租車庫存，實現 end-to-end 的租車預訂服務，為旅客打造更全面的體驗。透過與遍佈 190 多個國家的 47,000 家供應商建立合作關係，合作夥伴能大幅擴充其服務項目並提升預訂量。我們的 API 具備模組化設計，您可以輕鬆自訂旅客行程，以達成業務需求。
我們的端點為開發人員提供全面的租車服務存取權限，支援多項功能，包括查詢各據點的可用車輛、查看價格詳情及可選加購項目、註冊付款方式、建立預訂、檢索預訂詳情，以及辦理取消手續。請參閱以下內容，了解「/cars」流程的整體概覽：
了解端點
由於本產品目前仍處於早期體驗階段，請注意，其資料結構細節與功能仍在積極開發中，在正式向合作夥伴發布前，相關內容可能會有所變更。
| 操作 | 方法 | REST URI | 結果 |
|---|---|---|---|
| 搜尋車輛 | GET | /cars/availability | 根據各 種條件 (e.g. pick-up, drop-off,) 及搜尋範圍，回傳可用的租賃車輛，每筆請求最多回傳 200 輛車。回覆內容包含租車編號、pick-up/drop-off 取車地點、車型、里程數等詳細資訊。 |
| 查看詳細資訊 | GET | /cars/{car_rental_id}/details | 回報特定車輛的詳細資訊，包括價格明細、選配項目及相關條款。 |
| 為此預訂登記付款方式 | POST | /payments | 回傳一個付款代號，該代號將被放入建立預訂請求的請求主體中。此端點與其他 API 中的端點不同。 |
| 立即預訂 | POST | /itineraries/car | 完成預訂程序。 |
| 檢視預訂 | GET | /itineraries/car | 透過 . 取得預訂的詳細資訊affiliate_reference。 |
| 檢視行程 | GET | /itineraries/{itinerary_id}/car | 透過 . 回傳行程詳情itinerary_id。 |
| 取消預訂 | DELETE | /itineraries/{itinerary_id}/car | 取消現有預訂。 |
用例
以下說明如何使用 Rapid Car API 打造 end-to-end 的預訂體驗。
步驟 1：尋找理想的車款
使用/cars/availability，讓客戶能根據其所在地點和日期搜尋可用的車輛。
注意：系統最多會返回 200 筆結果。
| 關鍵參數 | 說明 | 建議 |
|---|---|---|
pickup_time | 租車的取車時間。 | 以擴展 ISO 8601 格式表示：e.g. 2018-02-12T11:59:00.000Z |
dropoff_time | 租車還車時間。 | 以擴展 ISO 8601 格式表示：e.g. 2018-02-12T11:59:00.000Z |
pickup_area | 車輛取車地點以半徑和座標表示。 | 格式為radius,latitude,longitude,e.g. 10,37.9838,23.7275。只需選擇pickup_area 或pickup_airport 其中一個即可。 |
dropoff_area | 指定的車輛還車地點以半徑和座標表示。 | 格式為radius,latitude,longitude,e.g. 10,37.9838,23.7275。僅允許使用dropoff_area 或dropoff_airport 其中一個網址。 |
pickup_airport | 將取車的機場。 | 只需選擇pickup_area 或pickup_airport 其中一個即可。 |
dropoff_airport | 將車輛歸還的機場。 | 僅允許使用dropoff_area 或dropoff_airport 其中一個網址。 |
driver_age | 駕駛人的年齡，若未滿 30 歲或已滿 70 歲。 | 除非駕駛員的年齡被標示為超出此範圍，否則應使用預設值 40。 |
currency | 匯率的目標貨幣。 | 採用 ISO 4217 格式表示，e.g. 美元。 |
language | 回應所使用的語言。 | 請僅使用 ISO 639-1 alpha-2 語言代碼。請查閱及此清單 以獲取更多資訊。 |
country_code | 旅客購買地點的國家代碼。 | 以 ISO 3166-1 alpha-2 格式呈現。此處應填寫交易發生所在的國家。 |
rental_company | 可依租車公司進行篩選。 | 透過多次重複使用 rental_company 查詢參數，最多可指定 20 家租賃 公司。 |
步驟 2：查看詳細資訊
請使用/cars/{car_rental_id}/details 端點來擷取額外的車輛資訊，包括價格明細與保單內容。
步驟 3：向客戶確認其選擇的付款方式
現在您可以使用payments 端點，讓客戶為該預訂註冊付款方式。
回應中將包含一個 payment_token，該參數需放入建立預訂請求的主體中。
步驟 4：建立預訂
/cars/{car_rental_id}/details的回應會返回一個連結，用於完成付款流程並建立預訂。/itineraries/car端點可讓預訂程序完成。
步驟 5：檢索預訂
若要檢視預訂詳情，請呼叫/itineraries/{itinerary_id}/car 端點以取得您的確認編號。