Rapid Activities API 概覽

透過 Rapid Activities API，讓旅客能夠預訂各項活動與體驗

搶先體驗預覽版

本文件屬於一項僅限特定合作夥伴參與的「搶先體驗」預覽計畫。Beta 測試計畫將於 2026 年第三季啟動，並於 2027 年全面推出。

如果您有興趣成為 Beta 合作夥伴，請聯絡您的客戶經理。

Rapid Activities API 旨在透過易於整合的 end-to-end 購物與預訂流程，協助您向旅客展示各項活動。這不僅能為旅客提供更全面的體驗，同時也能讓您開拓新的營收來源。

關鍵概念

期限	定義
旅遊活動	可預訂的活動 (您展示並銷售的內容)。
活動小組	一組類似的活動。
旅客體驗	一種概念性／行銷性的框架，其中可能包含多項活動。
門票	活動的預訂類型 (成人／兒童／嬰兒等)。
行程	一項預訂 (活動預約)，包含一項活動及一張或多張門票。
類別	High-level 將體驗與活動依主題進行分類的群組 (例如：城市導覽、博物館或戶外活動)。
屬性	描述性標籤，用以呈現某項體驗或活動的特定特徵 (例如：無障礙設施、「適合家庭」、「導覽行程」或「免排隊」)。

端對端整合流程

透過此 API 預訂活動的流程大致如下。

步驟 1：查閱庫存

首先，建立一份按目的地分類、結構清晰且可直接用於商品展示的活動目錄。這份型錄將有助於您了解在該地區有哪些商品可供您銷售。

建立目錄

使用 region-mapping 端點，將地理區域與底層清單 (體驗、活動及活動群組) 進行對應。註：在此版本中，Activities API 僅支援region_ID 參數。

>> 進一步了解區域相關資訊 2. 擷取多種語言的豐富活動內容 (標題、描述、圖片、地點及類別)。 3. 匯出各項活動的旅客評分與評論，協助旅客比較不同選項，並建立對該體驗的信任。 4. 在搜尋結果、活動詳情頁面以及篩選條件 (例如「適合家庭」或「步行導覽」) 中填入內容。

依地區及區域篩選

透過 Rapid Activities API，您可以使用area 查詢參數來篩選結果，以在由region_id 及area 座標所定義的區域交集範圍內進行探索。此功能旨在協助您減少自訂篩選邏輯，並向旅客顯示可能位於特定地點 (例如飯店) 附近的活動。

若要使用「area」篩選器，請在其中包含radius_km、latitude 及longitude 這三個欄位，以指定要回傳的活動地理範圍。

要求範例

GET /v2/regions/{region_id}/activity-groups?area=10,34.0512226,-118.2403994&pagination_size=25

注意： radius_km（area 中的第一個欄位）必須為大於或等於 0 的整數。

步驟 2：查詢空房狀況與價格

了解各項活動的開放時間及價格。善用可預約的日期／時間、票券選項及價格區間，以優化消費旅程。

有關具體活動及日期，請依票種查詢空位狀況及價格。
在購物者體驗中顯示行事曆 (可用／不可用日期)、時段及起始價格。
在單次呼叫中支援多項活動。

步驟 3：Pre-booking 價格查詢

在付款前，請確認最終可預訂價格，並取得所需預訂欄位的清單。收到經確認的報價及預訂代碼，內容均依據最新的房源資訊與政策而定。

即時驗證特定選項 (活動、日期、時間及門票)。
取得最終價格、稅金／手續費及庫存狀況 (包括價格變動或售罄資訊)。
取得有關預訂必填欄位 (例如乘客資料或 pick-up 類型) 的詳細資訊，以及用於預訂的安全憑證。

步驟 4：建立預訂

將已確認的選項轉為預訂。您將收到一份已確認的行程表 (預訂)，可於您的系統中顯示及管理。

請將購物流程中的預訂標記作為查詢參數傳送，並將 Payments API 中的payment_token 連同旅客詳細資料 (主要旅客及附加旅客) 一併包含在請求正文中。
請填寫您自己的聯盟夥伴代碼，以便日後進行預訂對帳與搜尋。
您將收到行程編號及用於查詢預訂詳情的連結。

步驟 5：管理預訂

支援客戶與客服專員的預訂後工作流程。使用完整的預訂後管理工具組，以檢視、取消現有預訂，並提供兌換券。

透過行程編號或您的合作夥伴參考編號查詢預訂詳情。
在允許的情況下取消預訂，並將後續狀態呈現給客戶。
請調取客戶在活動中出示的兌換券文件。

可退款房價

「快速活動」API 支援根據「可退款費率」屬性篩選活動，以標示在所列取消期限內取消時可獲得退款的活動。此功能旨在減少對自訂篩選邏輯的需求，並向旅客展示提供更彈性取消政策的活動。

篩選可退費的活動

對於可退款費率，請使用attribute_id 參數，並設定其屬性 ID 為 25。

GET /v2/regions/{region_id}/activities?attribute_id=25

注意：在向旅客顯示取消條款時，您應繼續使用回應中提供的政策資訊。

請求範例

GET /experiences/activities/content?language=en-US&activity_id=703295&activity_id=973888&activity_id=975441&activity_id=1006352&supported_booking_data_types=*&attribute_id=25

測試錯誤回應

若要針對特定的 Rapid Activities API 方法發送測試請求，請在您的購物或預訂請求中加入一個名為test 的額外 HTTP 標頭，並使用下表中對應的值。若未傳送測試標頭，或傳送了無效的測試標頭，將導致該請求被當作正式請求進行處理。

注意：使用測試標頭會返回靜態訊息，因此所返回的費率與內容可能與正在測試的活動無關。

購物與內容 API

測試標題值	HTTP 代碼與回應	狀態
標準	200 OK (標準成功回應)	成功
`bad_link`	400 錯誤請求 (連結錯誤)	錯誤
`invalid_input`	400 錯誤請求 (輸入無效)	錯誤
`internal_server_error`	500 內部伺服器錯誤 (未知錯誤)	錯誤
`service_unavailable`	503 服務不可用	錯誤

預訂 API

測試標題值	HTTP 代碼與回應	狀態
標準	200 OK (標準成功回應)	成功
`bad_link`	400 錯誤請求 (連結錯誤)	錯誤
`invalid_input`	400 錯誤請求 (輸入無效)	錯誤
`price_mismatch`	409 衝突 (價格不符)	錯誤
`sold_out`	410 衝突 (已售罄)	錯誤
`internal_server_error`	500 內部伺服器錯誤 (未知錯誤)	錯誤
`service_unavailable`	503 服務不可用	錯誤

API 詳細資料

請瀏覽本頁面的 activity-related 端點定義，然後使用 Postman 等測試軟體，了解範例與架構定義與實際輸出結果之間的差異。當此 API 通過試行階段後，其端點也將納入我們的 API Explorer 中。