Rapid Activities API 概覽

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

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

關鍵概念

端到端整合流程

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

步驟 1：查看庫存

了解在各旅遊目的地可銷售的項目，並依目的地建立一套結構化的活動目錄，以便隨時進行商品化。

• 請使用區域映射端點，將區域 映射至底層庫存 (體驗、活動及活動群組)。注意：在本次版本中，Activities API 僅支援 ``region_ID 參數。
• 擷取多種語言的豐富活動內容 (標題、描述、圖片、地點及類別)。
• 匯集各項活動的旅客評分與評論，協助旅客比較不同選項，並建立對該體驗的信任。
• 在搜尋結果、活動詳情頁面及篩選條件中顯示相關內容 (例如「適合家庭」或「步行導覽」)。

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

了解各項活動的開放時間及價格。善用可預約的日期/時間、票券選項及價格區間，為購物旅程注入動能。

• 如需了解具體活動及日期，請依票種查詢空位狀況與價格。
• 在購物體驗中顯示行事曆 (可用/不可用的日期)、時段以及起始價格。
• 單次呼叫中支援多項活動。

步驟 3：Pre-booking 價格查詢

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

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

步驟 4：建立預訂

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

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

第 5 步：管理預約

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

• 透過行程編號或您的合作夥伴參考編號查詢預訂詳情。
• 在允許的情況下取消預訂，並將處理後的狀態回報給客戶。
• 請為客戶調取活動憑證文件，以便他們在活動現場出示。

測試錯誤回應

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

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

購物與內容 API

預訂 API

API 詳細資料

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