通知

訂位相關各類事件的即時通知，助您簡化營運流程並有效擴展業務

「通知」服務讓您能與 Rapid Flight 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": "2027-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": "2027-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": "2027-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": "2027-12-10T17:15:22.954Z",  
  "event_type": "itinerary.supplier.refund",  
  "itinerary_id": "9025417466019",  
  "message": "The supplier initiated a refund for this flight itinerary."  
}

未指定型別的 void 程式碼範例

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