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。 | |
| 取消预订 | DELETE | /行程/{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 年底之前更新到下一个版本，届时此版本将会过时。