通知 API

發送活動預約的自動訊息，以簡化營運流程並有效擴展業務規模

透過「通知 API」，您能比以往更緊密地與「Rapid API」進行整合。當發生可能影響您的業務或營運的預訂變更時，通知 API 會將變更詳情直接推送給所有受影響的當事方。訊息可由代理商、供應商以及「Rapid API」本身發起。這表示，若客服專員進行變更，或供應商取消預訂，您將會收到通知。同樣地，如果 API 成功建立了一筆新預訂，您將會收到一則通知，可藉此確保與內部系統保持同步。

註：在 Lodging API 中，我們已支援來自代理商、供應商以及 Rapid API. 在「車程與活動」API 中，我們目前支援透過 agent-initiated 進行的預訂變更，並將於近期支援透過 Rapid API 以及由我們的供應商發起的變更。

「通知 API」可與您的業務無縫整合，並能與其他合作夥伴及客戶支援服務相輔相成。隨著我們為 Rapid API, 新增各項功能與特性，我們也將新增通知事件類型，以提升您的使用體驗。

事件結構描述與詳細資料

所有 POST 通知事件均採用下方概述的結構描述。系統會針對不同事件新增事件類型，因此結構描述可能有異。

物件	說明
`event_id`	每個事件的獨有識別碼。
`event_type`	指出是哪個事件觸發了通知。此值可用於處理和路由傳送訊息。如需詳細資訊，請參閱事件類型清單。
`event_time`	事件通知的時間戳記 (以世界協調時間 UTC 顯示)。
`itinerary_id`	受影響預訂的行程編號。
`email`	與受影響行程有關的客戶電子郵件地址。
`message`	該通知事件的相關資訊。對於類型為 `itinerary.message.received` 的事件，此處將包含供應商訊息的實際內容。如為其他所有事件類型，則將會是以英文撰寫、淺顯易懂地說明該事件的靜態內容。
`affiliate_reference_id`	受影響預訂的聯盟夥伴參考編號。
`topic_tags`	事件的主題標籤。只有 `itinerary.message.received` 這個類型的事件才會提供此標籤。這將是一份標籤清單，根據我們的分析，這些標籤可能出現在訊息的正文中。 >> 進一步了解旅宿訊息標籤
`line_of_business`	該活動所屬的業務類別。可能的值：`cars`、`flights`、`activities` 以及`packages`（`properties` 即將推出）。此欄位不適用於所有活動類型。註：此欄位目前適用於 Rapid Car、Flight 及 Activities API；Rapid Lodging API 尚未納入此欄位。
`file_name`	「file_name」欄位可讓合作夥伴確認是否已將正確的檔案附加至該對話中。註：此欄位僅適用於透過對話 API 傳送的附件。

每則通知皆為一則包含 JSON 訊息正文的HTTPS POST 請求。

注意：您必須針對每種活動類型分別啟用通知功能，才能收到該類型的通知。如果您想啟用新的通知事件類型，請聯絡支援團隊。

支援的事件類型

「快速通知」服務針對以下事件提供主動發送的通知訊息。Rapid 各業務線所支援的活動有所不同。

住宿 API

Lodging API 支援的事件

Rapid Lodging API 支援以下所有事件：

event_type 值	來源	事件	詳情
`itinerary.agent.create`	客戶服務專員或 Affiliate Voyager	建立預訂	Rapid 客戶服務專員，或 Affiliate Voyager 建立新預訂。
`itinerary.agent.change`	客戶服務專員或 Affiliate Voyager	更新預訂	Rapid 客戶服務專員，或 Affiliate Voyager 更新現有預訂。
`itinerary.agent.cancel`	客戶服務專員或 Affiliate Voyager	取消預訂	Rapid 客戶服務專員，或 Affiliate Voyager 取消現有預訂。
`itinerary.api.create`	Rapid API	透過 API 建立的行程	Rapid API 呼叫已成功建立一筆新預訂。注意：透過 API 發起預訂，有助於您在各系統間維持單一可信資料來源，從而減少「幽靈預訂」等問題。
`itinerary.api.create_failed`	Rapid API	透過 AP 建立行程失敗	Rapid API 嘗試建立預訂的動作已明確失敗。
`itinerary.api.change`	Rapid API	透過 API 更新行程	一則 Rapid API 呼叫變更了現有的預訂——無論是硬性變更 (例如客房、日期、付款方式) 還是軟性變更 (例如住客資料)。
`itinerary.api.cancel`	Rapid API	透過 API 取消行程	Rapid API 來電取消了這筆預訂。
`itinerary.fraud.cancel`	Expedia	取消預訂	現有預訂未遵循交易適用的條款和/或條件，因此遭到 Expedia 取消。旅客必須將自己的聯絡電話，以及方便討論取消事宜的時間傳送至 transactionprocessing@travelscape.com。
`itinerary.payment_verification.failure`	旅宿	信用卡付款變更連結	旅客於預訂時提供的支付卡已被 Expedia 標記為無效，詳情請參閱 pre-authorization. >> 進一步了解「信用卡重新扣款」功能
`itinerary.supplier.cancel`	旅宿	取消預訂	一筆現有預訂已被旅宿取消。旅客應聯絡您公司的客戶服務。
`itinerary.supplier.confirm`	旅宿	更新預訂	旅宿已更新該預訂的旅宿確認編號。
`itinerary.supplier.change`	旅宿	更新預訂	由於旅客抵達延誤或提早退房，現有預訂已由旅宿進行變更。
`itinerary.supplier.refund`	旅宿	更新預訂	針對 Expedia Collect 的預訂，旅宿正在處理旅客申請的退款。合作夥伴應負責確保旅客收到退款。
`itinerary.traveler.noshow`	旅宿	旅客預訂後未入住	旅客並未現身；因此，旅宿將該預訂標記為「未到場」。
`itinerary.traveler.checked_in`	旅宿	旅客在旅宿辦理報到手續	根據供應商的記錄，該旅客在旅宿辦理了入住手續。
`itinerary.unspecified.cancel`	Expedia	預訂遭未指明的一方取消	當預訂被取消，但系統無法辨別該取消是由旅客、旅宿/房東，還是代理商發起時，系統會發送此通知。此功能主要適用於 Rapid API 上的 Vrbo 預訂，當無法確定取消方時，以及適用於無法確定取消方的航班行程取消情況。由於取消的來源無法確定，合作夥伴僅憑通知內容，無法辨別是誰發起取消的。
`itinerary.unspecified.change`	Expedia	預訂遭不明人士變更	當現有預訂被變更 (即「硬性變更」) 時，系統若無法辨識該變更是由旅客、旅宿/host 還是代理商發起，便會發送此通知。它主要用於 Vrbo 上的預訂，網址為 Rapid API. 收到此通知後，合作夥伴應執行「預訂擷取」呼叫，以確認有哪些變更，並查看更新後的預訂詳情。
`itinerary.message.received`	旅宿	已傳送新訊息	旅宿已透過旅宿訊息中心 (PMC) 或對話 API 傳送了一則新訊息。 >> 進一步了解我們的對話解決方案
`itinerary.message.rejected`	需求方夥伴／旅客	偵測到詐騙或網路釣魚行為	由於某則由旅客或需求合作夥伴代理發送的訊息被判定為具有詐騙或網路釣魚性質，因此該訊息已被屏蔽。該訊息已被攔截，未能送達。
`itinerary.conversation.attachment.success`	需求方夥伴／旅客	附件上傳成功	由旅客或需求合作夥伴代理人在對話中傳送的附件已成功上傳，並新增至該對話中。
`itinerary.conversation.attachment.failure`	需求方夥伴／旅客	附件上傳失敗	由旅客或需求合作夥伴代理人在對話中傳送的附件，雖已上傳至 S3 儲存桶，但未能上傳至該對話中。

itinerary.agent.create 範例

{
     "event_id": "dbacce6c-afcb-4b23-ae66-48050757551c",
     "event_type": "itinerary.agent.create",
     "event_time": "2026-08-09T16:47:32.039Z",
     "itinerary_id": "8091234567890",
     "email": "customer@example.com",
     "message": "An agent created a new itinerary.",
     "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
 }

itinerary.supplier.confirm 範例

{
    "event_id": "e02d6f41-4708-476f-915d-8a7032942e94",
    "event_type": "itinerary.supplier.confirm",
    "event_time": "2027-04-28T20:31:03.423Z",
    "itinerary_id": "8999989898988",
    "email": "alice@example.com",
    "message": "The supplier confirmed one or more rooms on this itinerary.",
    "affiliate_reference_id": "R194193582",
    "rooms": [
        {
            "confirmation_id": {
                "expedia": "926784314",
                "property": "BEF23123AA"
            }
        },
        {
            "confirmation_id": {
                "expedia": "926784315"
            }
        }
    ]
}

itinerary.message.received 範例

{
  "event_id": "1aed5641-7285-4c42-b079-f5f2f139d148",
  "event_type": "itinerary.message.received",
  "event_time": "2027-11-14T02:33:18.860105363Z",
  "itinerary_id": "9025254271673",
  "email": "john@email.com",
  "message": " We accept your request for a river view room. You will be able to check in at 11:00 AM. Please also note that the pool will be closed for scheduled maintenance on the day of your arrival, it will be open normal hours (9 AM to 10 PM) for the remainder of your stay. Looking forward to your visit.",
  "topic_tags": "Check-in, Property/Amenity Closure",
  "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}

Car API

Car API 所支援的事件

目前，Rapid Car API 僅支援一種通知事件，即預訂取消。目前正在新增其他活動。一旦有貨，我們會在此列出。

event_type 值	來源	事件	詳情
`itinerary.agent.cancel`	客戶服務專員或 Affiliate Voyager	取消預訂	Rapid 客戶服務專員，或 Affiliate Voyager 取消現有預訂。

活動 API

Activities API 所支援的事件

目前，Rapid Activities API 支援兩種通知事件。目前正在新增其他活動。一旦有貨，我們會在此列出。

event_type 值	來源	事件	詳情
`itinerary.agent.cancel`	客戶服務專員或 Affiliate Voyager	取消預訂	Rapid 客戶服務專員，或 Affiliate Voyager 取消現有預訂。
`itinerary.supplier.cancel`	供應商	取消預訂	一項現有的預訂已被供應商取消。旅客應聯絡您公司的客戶服務。

API 詳細資料

在這個頁面上探索通知相關端點的定義，然後使用 API Explorer 或其他測試軟體，了解範例和結構描述定義與實際輸出的比較。我們還提供了一個「通知測試工具」，您可以藉此測試您與我們「通知 API」的整合情況。