通知 API

发送自动化消息以预订活动，从而简化您的操作并有效扩展规模。

通知 API 让您可以比以往任何时候都更紧密地与 Rapid API 集成。当预订变更可能影响您的业务或运营时，通知 API 会将变更详情直接推送给所有受影响方。消息可以由代理商、供应商和 Rapid API 本身发起。这意味着，如果呼叫中心客服人员做出更改或供应商取消预订，您将会收到通知。同样，如果 API 成功创建新预订，您将收到一条通知，您可以利用该通知与您的内部系统保持一致。

注意：在住宿 API 中，我们已经支持来自代理商、供应商和 Rapid API 的消息。在汽车和活动 API 中，我们目前支持 agent-initiated 预订变更，并将很快支持在 Rapid API 中以及由我们的供应商发起的变更。

通知 API 可与您的业务无缝集成，并可与其他合作伙伴和客户支持服务相辅相成。随着我们为 Rapid API 添加特性和功能，我们还将添加新的通知事件类型，以改善您的体验。

事件模式和详细信息

所有 POST 通知事件都遵循下述模式。由于针对不同的事件添加了新事件类型，该模式可能会有所不同。

对象	说明
`event_id`	每个事件的唯一标识符。
`event_type`	指示导致发送通知的事件。此值可用于消息处理和路由。有关详细信息，请参考事件类型列表。
`event_time`	事件通知的时间戳，采用 UTC。
`itinerary_id`	受影响预订的行程 ID。
`email`	与受影响行程关联的客户邮箱地址。
`message`	有关通知事件的信息。对于类型为`itinerary.message.received`的事件，此处将包含供应商消息的实际文本。在所有其他事件类型中，此处将是对事件的静态人性化描述（英文。
`affiliate_reference_id`	受影响预订的联盟伙伴参考 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 字段允许合作伙伴验证是否已将正确的文件附加到对话中。注意：此字段仅适用于通过 Conversation API 发送的附件。

每条通知都是一个带有 JSON 消息体的 HTTPS POST 请求。

**注意：**您需要分别启用每种事件类型才能接收这些类型的通知。如果您想启用新的通知事件类型，请联系支持人员。

支持的事件类型

快速通知服务可针对以下事件提供主动消息。Rapid 各业务线支持的事件有所不同。

住宿 API

住宿 API 支持的事件

快速住宿 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`	住宿	预订更新	酒店已更新预订确认 ID。
`itinerary.supplier.change`	住宿	预订更新	由于旅客延迟抵达或提前退房，酒店更改了现有预订。
`itinerary.supplier.refund`	住宿	预订更新	对于 Expedia 收集的预订，酒店正在提供旅客要求的退款。合作伙伴有责任确保旅客收到退款。
`itinerary.traveler.noshow`	住宿	旅客预订后未入住	旅客没有出现；因此，酒店将预订标记为“未入住”。
`itinerary.traveler.checked_in`	住宿	旅客在酒店办理入住手续	根据供应商的记录，旅客已办理入住手续。
`itinerary.unspecified.cancel`	Expedia	预订被不明方取消。	当预订被取消，但系统无法确定取消是由旅行者、房东/业主还是代理商发起时，系统会发送此通知。它主要用于 Rapid API 上的 Vrbo 预订，其中无法确定取消方，以及取消方未知的航班行程取消。由于取消的来源不确定，合作伙伴无法仅凭通知来区分是谁发起的取消。
`itinerary.unspecified.change`	Expedia	预订信息被不明方更改	当现有预订发生变更（“硬性变更”）时，系统会发送此通知，但系统无法识别变更是由旅行者、酒店/房东还是代理商发起的。它主要用于在 Rapid API 上进行 Vrbo 预订。收到此通知后，合作伙伴应执行预订检索调用，以确定更改了哪些内容并查看更新后的预订详情。
`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"
}

租车 API

车辆 API 支持的事件

目前，Rapid Car API 仅支持一种通知事件，即取消预订。我们正在添加更多赛事。我们会把它们列出来，等它们上市后就会在这里发布。

event_type 值	来源	活动	详细信息
`itinerary.agent.cancel`	客户支持客服或 Affiliate Voyager	预订取消	Rapid 客户支持客服或 Affiliate Voyager 取消了一个现有预订。

当地玩乐 API

活动 API 支持的事件

目前，快速活动 API 支持两种通知事件。我们正在添加更多赛事。我们会把它们列出来，等它们上市后就会在这里发布。

event_type 值	来源	活动	详细信息
`itinerary.agent.cancel`	客户支持客服或 Affiliate Voyager	预订取消	Rapid 客户支持客服或 Affiliate Voyager 取消了一个现有预订。
`itinerary.supplier.cancel`	提供商	预订取消	供应商取消了现有预订。客户应与您企业的客户支持联系。

API 详情

查看此页面上与通知相关的端点定义，然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较。我们还有一个通知测试工具，可用于测试您与我们的通知 API 的集成。