通知

获取各种预订事件的提醒，以简化您的操作并有效扩展规模。

通知服务可让您与 Rapid Flight API 紧密集成。当预订变更可能影响您的业务或运营时，通知服务会将变更详情通过标准消息直接推送至您的系统。POST 借助这些推送通知，您可以了解情况、简化操作并扩大业务规模。

我们目前支持在我们的 API 之外发生的 post-booking 事件的通知。例如，如果呼叫中心客服人员更改或取消预订，您将立即收到通知。

随着我们不断为 Rapid Flight API 添加特性和功能，我们通常也会添加新的通知事件类型，以改善您的体验。

通过与您的业务无缝集成，这些通知可以补充 Rapid API, Affiliate Voyager, 和其他合作伙伴及客户支持服务。

活动详细信息

所有POST通知事件均遵循以下列出的值。随着不同事件类型不断增加，其数值可能会有所不同。

对象	说明
`affiliate_reference_id`	受影响预订的联盟伙伴参考 ID。
`email`	与受影响行程关联的客户邮箱地址。
`event_id`	每个事件的唯一标识符。
`event_time`	事件通知的时间戳，采用 UTC。
`event_type`	指示导致发送通知的事件。此值可用于消息处理和路由。有关详细信息，请参考事件类型列表。
`itinerary_id`	受影响预订的行程 ID。

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

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

支持的事件类型

航班通知服务可以通过消息将以下事件通知您的系统：

`event_type` 价值	来源	活动	详细信息
`itinerary.supplier.ticket`	航空公司	航班预订	航空公司已确认预订并出票（适用于已出票航班）。
`itinerary.unspecified.change`	多个	航班变更	现有预订由旅客、代理商或航空公司更新（例如，航班时刻表变更等非自愿变更）。
`itinerary.unspecified.cancel`	多个	航班取消	旅客、航空公司或代理商取消了现有预订。
`itinerary.supplier.refund`	航空公司	机票退款	航空公司正在为旅客提供退款。如果航空公司是登记商户，则航空公司有责任确保旅客收到退款。
`itinerary.unspecified.void`	多个	飞行空洞	旅客、航空公司或代理商取消了现有预订。

供应商票务代码示例

{  
    "affiliate_reference_id": "",  
   "email": "abc123@gmail.com",  
   "event_id": "dcec1653-3b7f-4b03-b056-50176642869d",  
   "event_time": "2025-12-10T17:15:13.115Z",  
   "event_type": "itinerary.supplier.ticket",  
   "itinerary_id": "9025417059279",  
   "message": "The supplier issued a ticket for this flight itinerary."  
}

未指定的变更代码示例

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
 "event_id": "ab1bce97-175d-43d9-91c8-b09cdbf5ea46",  
  "event_time": "2025-12-10T17:15:21.016Z",  
  "event_type": "itinerary.unspecified.change",  
  "itinerary_id": "9025417973523",  
  "message": "This flight itinerary was changed."  
}

未指定的取消代码示例

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
  "event_id": "221b5da6-820a-4e7b-85bd-1ba7639abda1",  
  "event_time": "2025-12-10T17:15:16.840Z",  
  "event_type": "itinerary.unspecified.cancel",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was canceled."  
}

供应商退款代码示例

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.supplier.refund",  
  "itinerary_id": "9025417466019",  
  "message": "The supplier initiated a refund for this flight itinerary."  
}

未指定的无效代码样本

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.unspecified.void",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was voided."  
}