Rapid Car API 概覽
建立穩健的 end-to-end 租車預訂系統
Car API 套件
Rapid Car API 透過 Expedia Group's 提供的豐富租車庫存，支援 end-to-end 的租車預訂服務，為旅客打造更全面的體驗。透過與遍佈 190 多個國家／地區的 47,000 家供應商建立合作關係，合作夥伴能夠大幅擴充其服務項目並提升預訂量。我們的 API 具備模組化設計，您可以輕鬆自訂旅客行程，以達成業務需求。
我們的端點為開發人員提供全面的租車服務存取權限，可實現諸如查詢各據點的可用車輛、查看價格詳情及可選加購項目、註冊付款方式、建立預訂、檢索預訂詳情以及辦理取消等功能。
旅客與 Car API 的互動
了解終點
由於本產品目前仍處於早期體驗階段，請注意，其資料結構細節與功能仍在積極開發中，並可能在正式向合作夥伴發布前有所變更。
| 操作 | 方法 | 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. 2027-02-12T11:59:00 |
dropoff_time | 租車的還車時間。 | 以擴展 ISO 8601 格式表示：e.g. 2027-02-12T11:59:00 |
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 歲。 | 我們建議，當駕駛人年齡既未低於 30 歲，亦未高於 70 歲時，預設值應為 40；除非貴轄區有特定規定。 |
currency | 匯率的目標貨幣。 | 以 ISO 4217 格式表示，為 e.g. 美元。 |
language | 回應所使用的目標語言。 | 語言格式必須使用 ISO 639-1 的 2 字元語言代碼，加上 BCP-47 的 2 字元地區代碼。 >> 查看 Rapid 支援的所有語言 |
country_code | 旅客購買地點的國家代碼。 | 以 ISO 3166-1 alpha-2 格式呈現。此處應填寫交易發生所在的國家。 |
traffic_profile | 搜尋所使用的網站版本 (例如：web 與 App) | 當您設定網站時，我們會協助您設定此字串值。 |
步驟 2：查看詳細資訊
請使用/cars/{car_rental_id}/details 端點來擷取額外的車輛資訊，包括價格明細及相關條款。
步驟 3：向客戶了解其選擇的付款方式
現在您可以使用payments 端點，讓客戶為該預訂註冊付款方式。
回應中將包含一個 payment_token，該參數需放入「建立預訂」請求的主體中。
步驟 4：建立預訂
/cars/{car_rental_id}/details的回應會返回一個連結，用以完成付款流程並建立預訂。/itineraries/car端點可讓預訂程序完成。
步驟 5：檢視預訂
若要查詢預訂詳情，請呼叫/itineraries/{itinerary_id}/car 端點以取得 Expedia 設定的確認編號，或呼叫/itineraries/car?affiliate_reference_id={affiliateReferenceId} 以取得您這邊指派的編號。