Rapid Car API 測試版文檔
搶先體驗預覽
本文檔是僅針對選定合作夥伴的早期存取預覽計畫的一部分。一項試點計畫於 2025 年第二季啟動，目前測試版計畫正在運行，並將於 2026 年全面推出。
如果您已經是合作夥伴並且有興趣成為早期採用者，請聯絡您的客戶經理。如果您還不是合作夥伴，請加入等待名單。
/cars API 包
Rapid Car API 支援 end-to-end 汽車租賃預訂，由 Expedia Group 令人印象深刻的汽車租賃庫存提供支持，為旅行者創造更全面的體驗。透過與 190 多個國家的 47,000 家供應商建立聯繫，合作夥伴可以大幅擴大其產品範圍並增加預訂量。我們的 API 具備模組化設計，您可以輕鬆自訂旅客行程，以達成業務需求。
我們的端點為開發人員提供了全面的汽車租賃服務訪問權限，實現了諸如搜索所有地點的可用車輛、查看價格詳情和可用的附加服務、註冊付款方式、創建預訂、檢索預訂詳情以及執行取消等功能。請參閱下文以了解 /cars 流程的總體視圖：
了解端點
由於該產品仍處於早期訪問階段，請記住，架構細節和功能仍處於積極開發中，在向合作夥伴全面發布該產品之前可能會發生變化。
| 操作 | 方法 | REST URI | 結果 |
|---|---|---|---|
| 搜尋汽車 | GET | /汽車/可用性 | 根據各種標準、e.g. pick-up, drop-off, 和搜尋半徑返回可用的不同租賃汽車，每個請求最多 200 輛汽車。回應包括汽車租賃 ID、pick-up/drop-off 位置、汽車類型、里程等詳細資訊。 |
| 看詳情 | GET | /汽車/{car_rental_id}/詳細信息 | 返回特定汽車的詳細信息，包括價格明細、可選附加功能和政策。 |
| 註冊預訂的付款方式 | POST | /付款 | 傳回一個付款令牌，該令牌隨後將進入建立預訂請求的正文中。此端點與其他 API 中的端點不同。 |
| 進行預訂 | POST | /行程/汽車 | 完成預訂流程。 |
| 檢索預訂 | GET | /行程/汽車 | 返回預訂的詳細資訊affiliate_reference。 |
| GET | /行程/{itinerary_id}/汽車 | 返回行程詳情itinerary_id。 | |
| 取消預訂 | 刪除 | /行程/{itinerary_id}/汽車 | 取消現有預訂。 |
用例
您可以使用以下方法使用 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中的一個。 |
currency | 匯率所需的貨幣。 | 以 ISO 4217 格式給出，e.g。美元。 |
language | 回應所需的語言。 | 僅使用 ISO639-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 端點以取得您的確認 ID。
喜歡新的 Rapid Cars API 的外觀嗎？那麼您可能也會對我們即將推出的航班和活動 API 感興趣。請與您的客戶經理聯繫以獲取更多資訊。
API 詳細資料
探索此頁面上的 cars-related 端點定義，然後使用測試軟體來了解範例和模式定義與實際輸出的比較。當此 API 完成測試階段後，其端點也會包含在我們的 API Explorer 中。
重要提示
請勿基於此版本的模式進行開發；我們將其包含在內僅供參考。我們將在 2025 年底之前更新到下一個版本，屆時此版本將會過時。