Your EPS account
Sign in to view secure API documentation, update your account details, log support requests and much more.
Your email or password is incorrect. Please try again or reset your password.
If the issue persists please contact your EPS representative.
Reset your password
Please enter your email address below. We will send password reset instructions to the email associated with your EPS account.
Thank you
An email has been sent to your account email address with further instructions on how to reset your password.
概要
EPS 通知は、これまで以上に EPS を活用していただくためのソリューションです。ビジネスに影響する変更があった場合、EPS は標準的な POST メッセージを使用して、お客様のシステムに直接その変更の詳細をお知らせします。 このプッシュ通知により、常に最新情報を入手でき、作業を簡素化し、ビジネスを拡大できます。
現在、EPS の API 外部で発生する予約イベントすべてに対して通知をサポートしています。そのため、コール センターから変更されたり、ホテルが予約を取り消した場合でも、すぐにその情報が通知されます。このサービスは開始されたばかりです。通知イベントの種類は今後間もなく増える予定です。
このような通知サービスは、ビジネスのシームレスな統合を可能にし、次のような EPS の製品やサービスを補完します。
- EPS Rapid API
- Affiliate Voyager エージェント予約ツール
- パートナーとお客様のサポート サービス
新しいツール 通知でサポートされるすべてのイベント タイプに Test API を利用できるようになりました。詳細については、後述の主要なセクションを参照してください。独自のリクエストを設定しない場合は、新しい通知テスター ツールも利用できます。
サポートするメッセージ タイプ
EPS 通知では次のような事象に対するメッセージでシステムに通知します。
発生元 | 発生イベント | 詳細 |
---|---|---|
カスタマー サポート エージェントまたは Affiliate Voyager | 予約の作成 | EPS カスタマー サポート エージェントまたは Affiliate Voyager で新しい予約が作成されました。 |
予約の更新 |
EPS カスタマー サポート エージェントまたは Affiliate Voyager で既存の予約が更新されました。 |
|
予約の取り消し | EPS カスタマー サポート エージェントまたは Affiliate Voyager で既存の予約が取り消されました。 | |
ホテル | 予約の取り消し | 既存の予約がホテルによって取り消されました。 お客様は担当のカスタマー サポートに連絡する必要があります。 |
エクスペディア | 予約の取り消し |
予約がトランザクションの適用条件に合致しないため、既存の予約がエクスペディアによって取り消されました。 お客様は、電話番号、取り消しに関する相談に都合のよい日時を、transactionprocessing@travelscape.com まで連絡する必要があります。 |
メッセージの構成と詳細
すべてのメッセージは次に示すような構成になっています。さまざまなイベントに新しいメッセージ タイプが加えられるため、この構成は変更されることがあります。
オブジェクト | 説明 |
---|---|
event_id |
各メッセージの一意の識別子 |
event_type |
どのイベントが通知の原因となったかを示します。 この値はメッセージのハンドリングとルーティングに使用できます。 詳細についてはイベント タイプのリストを参照してください。 |
event_time |
イベント通知のタイプスタンプ (協定世界時) |
itinerary_id |
影響を受ける予約の旅程 ID |
email |
影響を受ける旅程に関連するお客様のメール アドレス |
message |
イベント通知の記述 |
affiliate_reference_id |
影響を受ける予約のアフィリエイト参照 ID |
サポートするメッセージのトピックス
発生元 | 発生イベント | event_type の値 |
---|---|---|
カスタマー サポート エージェントまたは Affiliate Voyager | 予約の作成 | itinerary.agent.create |
予約の更新 | itinerary.agent.change |
|
予約の取り消し | itinerary.agent.cancel |
|
ホテル | 予約の取り消し | itinerary.supplier.cancel |
エクスペディア | 予約の取り消し | itinerary.fraud.cancel |
各メッセージは 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 レベルのステータス コードを受信しないメッセージはすべて未配信とみなされ、通知サービスによる再送信の対象となります。
結果を処理する | 詳細 | 応答ステータス コード |
---|---|---|
成功 |
|
200 |
失敗 |
|
400s |
|
500s |
配信不能メッセージ
メッセージをエンドポイントに正常に配信できない場合、次のスケジュールで自動的に再試行されます。
- 5 分後に最初の再試行。
- 1 時間後に 2 回目の再試行。
- 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 統合コンサルタントに問い合わせて問題を解決してください。
重要な注意事項
受け取る通知には、テスト通知と本番通知の区別はありません。テスト用のメッセージと本番用のメッセージを確実に区別できるように、テスト通知専用のエンドポイントを設定することを強くお勧めします。
テスト用と本番用に異なるエンドポイントを設定すれば、テスト通知はテスト用のエンドポイントでのみ受信し、本番用の通知は本番用のエンドポイントで受信するようになります。
EPS Home | EPS Portal Login | Expedia Partner Central | Advertise with Expedia | News | Privacy Policy | Cookie Policy
© 2020 Expedia, Inc. All Rights Reserved.