通知

様々な予約イベントのアラートを受け取ることで、オペレーションを簡素化し、効率的に拡張できます。

Notificationsサービスは、Rapid Flight APIと密接に統合することができます。お客様のビジネスや業務に影響を与える予約変更が発生した場合、Notificationサービスは、標準のPOST メッセージを通じて、変更の詳細をお客様のシステムに直接プッシュします。こうしたプッシュ通知により、常に最新情報を入手でき、運営を簡素化し、ビジネスを拡大できます。

現在、APIの外部で発生したpost-bookingイベントに対する通知をサポートしています。例えば、コールセンターの担当者が予約の変更やキャンセルをした場合、すぐにお客様に通知されます。

Rapid Flight APIに機能や特徴を追加する際、お客様の利便性を向上させるため、新しい通知イベントタイプを追加することもあります。

お客様のビジネスとのシームレスな統合を可能にするこれらの通知は、Rapid API, Affiliate Voyager,、その他のパートナーおよびカスタマーサポートサービスを補完する役割を果たします。

対応の詳細

すべてのPOST 通知イベントは、以下に概説する値に従います。イベントごとに新しいイベントタイプが追加されるため、値は異なる場合があります。

オブジェクト	説明
`affiliate_reference_id`	影響を受ける予約のアフィリエイト参照 ID。
`email`	影響を受ける旅程に関連付いているお客様のメールアドレス。
`event_id`	各イベントの一意の識別子。
`event_time`	イベント通知のタイプスタンプ (協定世界時)。
`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."  
}