快速活动 API 概述

抢先体验版

本文档是仅面向特定合作伙伴的早期访问预览计划的一部分。试点项目将于 2025 年第四季度启动，并于 2026 年全面推出。

如果您有兴趣成为试点或测试合作伙伴，请联系您的客户经理。

Rapid Activities API 旨在帮助您通过易于集成的 end-to-end 预订路径向旅行者展示活动和体验。这既能为旅行者提供更全面的预订体验，又能帮助您开拓新的收入来源。

以下步骤概述了如何与 Activities API 集成并构建您的预订路径。快速活动 API 由一系列端点组成，这些端点共同实现了 search-to-book 流程。

注意：由于本产品仍处于早期访问阶段，请注意，架构细节和功能仍在积极开发中，在向合作伙伴正式发布本产品之前可能会发生变化。

availability端点根据给定的位置和日期范围检索可用的活动和体验。

请查看以下关键参数：

关键参数	说明	建议
`start_date`	搜索可用活动的起始日期。	使用 ISO 8601 格式。例如，2018-02-12。
`end_date`	搜索可用活动的截止日期。	使用 ISO 8601 格式。例如，2018-02-12。
`currency`	汇率所需的货币单位。	使用 ISO 4217 格式。例如，美元。
`language`	期望的回复语言。	仅使用 ISO639-1 alpha 2 语言代码和 ISO3166-1 alpha 2 国家/地区代码。
`country_code`	旅行者消费点的国家代码。	使用 ISO 3166-1 alpha-2 格式。这应代表进行选购交易的国家/地区。例如，美国。
`region_id`	旅行者寻找活动的地点或区域。	例如，1122931。
`limit`	响应中返回的活动的最大数量。	最大值：100

offers端点为旅行者提供更多详细信息，包括他们所选活动的可用优惠，例如时间、价格和旅游可用性。

以下是旅客在预订前需要了解的详细信息：

一旦旅行者找到了完美的度假体验，即可使用 offer_id 端点来查看价格和所需的预订信息。

您现在可以使用该payments端点，允许客户注册预订的付款方式。响应中将包含一个，该 payment_token 会出现在创建预订请求的正文中。

使用 activity 端点创建预订。此端点将返回一个包含所有相关操作链接的itinerary_id。

您可以使用 activity 端点，通过行程 ID 检索预订详情。回复中将包含取消链接（如适用）。

浏览此页面上的 activity-related 端点定义，然后使用测试软件来了解示例和架构定义与实际输出的比较情况。当此 API 完成试点阶段后，其端点也将包含在我们的 API Explorer 中。