通知

概要

EPS 通知は、これまで以上に EPS を活用していただくためのソリューションです。ビジネスに影響する変更があった場合、EPS は標準的な POST メッセージを使用して、お客様のシステムに直接その変更の詳細をお知らせします。  このプッシュ通知により、常に最新情報を入手でき、作業を簡素化し、ビジネスを拡大できます。

現在、EPS の API 外部で発生する予約イベントすべてに対して通知をサポートしています。そのため、コール センターから変更されたり、ホテルが予約を取り消した場合でも、すぐにその情報が通知されます。このサービスは開始されたばかりです。通知イベントの種類は今後間もなく増える予定です。

このような通知サービスは、ビジネスのシームレスな統合を可能にし、次のような EPS の製品やサービスを補完します。

• EPS Rapid API
• Affiliate Voyager エージェント予約ツール
• パートナーとお客様のサポート サービス

新しいツール 通知でサポートされるすべてのイベント タイプに Test API を利用できるようになりました。詳細については、後述の主要なセクションを参照してください。独自のリクエストを設定しない場合は、新しい通知テスター ツールも利用できます。

サポートするメッセージ タイプ

EPS 通知では次のような事象に対するメッセージでシステムに通知します。

メッセージの構成と詳細

すべてのメッセージは次に示すような構成になっています。さまざまなイベントに新しいメッセージ タイプが加えられるため、この構成は変更されることがあります。

サポートするメッセージのトピックス

各メッセージは JSON のメッセージ本文を持つ HTTP POST リクエストです。

例 :

 { "event_id": "dbacce6c-afcb-4b23-ae66-48050757551c", "event_type": "itinerary.agent.create", "event_time": "2017-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" }

統合

メッセージを受信する

メッセージの受信を開始するには、公衆からのアクセスが可能な HTTPS エンドポイントを立ち上げ、そのエンドポイントに送られる POST メッセージを受信できるようにする必要があります。

EPS 統合コンサルタントと協力して設定し、次の情報を入力します。

• 受け取りを希望するイベント トピックのリスト (前述)
• メッセージを処理するエンドポイントの URL

今後、統合をテストするためのセルフ サービス ツールが提供される予定です。それまでは、統合コンサルタントがテスト予約をサポートし、受け取り希望のオフライン イベントに対する通知を受信していることを確認します。

設定に関する重要な注意事項

• EPS ではクラウド ベースのサーバーを使用しています。さまざまな IP アドレスからプッシュされる通知を受信できるよう受信者のエンドポイントが設定されていることを確認します。
• エンドポイントの URL を変更する場合は、新しい URL がプッシュ通知を受信できるようになるまで、元の URL を有効にしておく必要があります。該当する変更を行う前に、EPS 担当者にご連絡ください。
• 通知に使用できる URL は 1 つのみです。event_type やその他の基準に応じて変化させることはできません。

メッセージを処理する

予約イベントが発生したというメッセージを受信した場合、そのメッセージに記載された旅程 ID とメール アドレスを使用して、予約に関する最新の詳細を取得します。

メッセージは順不同で届く場合があります。タイムスタンプを参照して順番を確認し、予約イベントの旅程を検索して最新ステータスを取得します。

メッセージを受信後、適切な HTTP ステータス コードで統合結果を返答する必要があります。200 レベルのステータス コードを受信しないメッセージはすべて未配信とみなされ、通知サービスによる再送信の対象となります。

配信不能メッセージ

メッセージをエンドポイントに正常に配信できない場合、次のスケジュールで自動的に再試行されます。

1. 5 分後に最初の再試行。
2. 1 時間後に 2 回目の再試行。
3. 7 日間にわたり、12 時間ごとに連続的に再試行 (合計 14 回)

EPS が受信確認 (OK ステータス コード 200) を受信できなかった場合は、メッセージが重複して届く場合があり、さらにこのメッセージは再送信されます。元のメッセージと同じ event_id でそれより後の timestamp を探すことで、重複メッセージを識別できます。

通知テスト API

EPS 通知テスト API では、指定したテスト エンドポイントにテスト通知を送信するようリクエストして、通知サービスとの統合を確認できます。また、通知サービス テスターを使用して、独自のリクエストを作成せずにエンドポイントにテスト通知を直接送信することもできます。

重要な注意事項

このサービスのリクエスト機能は本番用の通知 API には存在しません。ライブ エンドポイントにリクエストを送信して本番用の通知をトリガまたはリフレッシュすることはできません。このテスト API を介して提供されるリクエストは、テスト専用のものです。

この API はテスト専用であるため、その GET リクエスト トリガは test.ean.com 経由でのみ利用できます。

メッセージの構成とサポートするメッセージのトピックス

すべてのテスト通知は、通知 API ドキュメントですでに述べたように、本番用の通知と同じ構成と同じメッセージのトピックスに準拠しています。

統合

メッセージを受信する

テスト通知の受信を開始するには、公衆からのアクセスが可能な HTTPS エンドポイントを立ち上げ、そのエンドポイントに送られる POST メッセージを受信できるようにする必要があります。

EPS 統合コンサルタントと協力して設定し、次の情報を入力します。

• テスト用に受け取りを希望するイベント トピックのリスト (前のセクションで記述)
• テスト通知を処理するテスト エンドポイントの URL

リクエストして 30 分経ってもテスト通知を受信できない場合は、EPS 統合コンサルタントに問い合わせて問題を解決してください。

重要な注意事項

受け取る通知には、テスト通知と本番通知の区別はありません。テスト用のメッセージと本番用のメッセージを確実に区別できるように、テスト通知専用のエンドポイントを設定することを強くお勧めします。

テスト用と本番用に異なるエンドポイントを設定すれば、テスト通知はテスト用のエンドポイントでのみ受信し、本番用の通知は本番用のエンドポイントで受信するようになります。