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：管理預訂
支援客戶與客服專員的預訂後工作流程。使用完整的預訂後管理工具組，以檢視、取消現有預訂，並提供兌換券。
- 透過行程編號或您的合作夥伴參考編號查詢預訂詳情。
- 在允許的情況下取消預訂，並將隨之產生的狀態呈現給客戶。
- 請調取顧客在活動中出示的兌換券文件。
行銷費用與毛利
透過 Rapid Activities API，您可以存取marketing_fee 及gross_profit 中的估算值，以了解一筆交易的預期收益。
marketing_fee此為您在該筆交易中預估的合夥收益：根據您與……的商業條款預先計算出的毛利份額：Expedia Groupgross_profit這是您與 Expedia Group; 之間預估的總利潤分配額；若您願意，可以使用此欄位取代marketing_fee，以套用您自己的分級邏輯
這兩個欄位都會出現在「庫存狀況」、「價格查詢」和「檢索」的回應中，並會在「價格查詢」階段重新計算，以反映自庫存狀況確定以來發生的任何價格變動。「檢索」回應反映了預訂的最新財務狀態，因此若該狀態已發生變更，其數值可能會與「價格查詢」中顯示的內容有所不同。
若您的 Rapid API 實作已啟用 Expedia Affiliate Collect（EAC)，您還會在「房況與價格查詢」的回應中看到marketing_fee_eac。此數值代表針對「EAC」給付途徑所估算的收入。「Retrieve」回應會回傳任何與實際用於完成預訂的付款路徑相符的欄位。
若您願意，可以設定這三個參數的存取權限；如需啟用此功能，請聯絡您的帳戶經理。
可退款房價
「快速活動」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 現已支援針對影響預訂的事件發送推播通知，因此您的系統無需進行輪詢，即可與 Rapid API 保持同步。
測試錯誤回應
若要針對特定的 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 中。