快速活動 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 中。