通知

為各種預訂事件設定提醒，簡化您的營運流程並有效擴展業務規模

通知服務讓您能與快速飛行 API 緊密整合。當發生可能影響您業務或營運的預訂變更時，通知服務將透過標準POST 訊息，將變更詳情直接推送至您的系統。這些推播通知可讓您隨時接收最新資訊、簡化作業以及調整業務範圍。

我們目前支援針對發生於我們 API 之外的 post-booking 事件所發送的通知。因此，舉例來說，若客服中心人員變更或取消預訂，您將立即收到通知。

隨著我們為 Rapid Flight API 增添新功能與特性，我們也經常同步新增通知事件類型，以提升您的使用體驗。

透過與您的業務無縫整合，這些通知能有效輔助 Rapid API, Affiliate Voyager, 及其他合作夥伴與客戶支援服務。

活動詳情

所有POST 通知事件均遵循以下所述的值。隨著不同活動新增事件類型，數值可能有所變化。

物件	說明
`affiliate_reference_id`	受影響預訂的聯盟夥伴參考編號。
`email`	與受影響行程有關的客戶電子郵件地址。
`event_id`	每個事件的獨有識別碼。
`event_time`	事件通知的時間戳記 (以世界協調時間 UTC 顯示)。
`event_type`	指出是哪個事件觸發了通知。此值可用於處理和路由傳送訊息。如需詳細資訊，請參閱事件類型清單。
`itinerary_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."  
}