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 訊息,直接將變更詳細資料推播至您的系統。 推播通知可讓您隨時接收最新資訊、簡化操作以及調整業務範圍。
我們目前支援在 API 外部發生的所有預訂活動通知。因此,若客戶服務中心發生變更或飯店取消預訂,您便會立即收到通知。這只是開始,很快地我們會支援更多通知活動類型。
這些通知功能與您的業務無縫整合後,可強化下列 EPS 產品與服務:
- EPS Rapid API
- Affiliate Voyager 服務專員預訂工具
- 合作夥伴與客戶服務
新工具我們現在為所有「通知」支援的活動類型提供「測試 API」。請查看下方的下一個主要區段瞭解詳細資訊。若您想要設定自己的要求,您也可以使用我們全新的「通知測試」工具。
支援的訊息類型
EPS 通知可將下列活動的通知訊息傳送到您的系統:
來源 | 活動 | 詳細資料 |
---|---|---|
客戶服務專員或 Affiliate Voyager | 建立預訂 | EPS 客戶服務專員,或 Affiliate Voyager 建立新預訂。 |
更新預訂 |
EPS 客戶服務專員,或 Affiliate Voyager 更新現有預訂。 |
|
取消預訂 | EPS 客戶服務專員,或 Affiliate Voyager 取消現有預訂。 | |
飯店 | 取消預訂 | 飯店取消現有預訂。 客戶應聯絡您公司的客戶服務。 |
Expedia | 取消預訂 |
現有預訂未遵循交易適用的條款和/或條件,因此遭到 Expedia 取消。 客戶必須將自己的聯絡電話,以及方便討論取消事宜的時間傳送至 transactionprocessing@travelscape.com。 |
訊息結構描述與詳細資料
所有訊息皆採用下方概述的結構描述。系統會針對不同活動新增訊息類型,因此結構描述可能有異。
物件 | 說明 |
---|---|
event_id |
每則訊息的獨有識別碼 |
event_type |
表示觸發通知的活動。 此值可用於處理和路由傳送訊息。 如需詳細資訊,請參閱活動類型清單。 |
event_time |
活動通知的時間戳記 (世界協調時間 UTC) |
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 |
Expedia | 取消預訂 | itinerary.fraud.cancel |
每則訊息皆為訊息本文為 JSON 格式的 HTTPS 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 接收通知:不支援
event_type
的變體或其他條件。
處理訊息
您接收預訂活動已發生的訊息時,請使用該訊息中的行程 ID 和電子郵件地址來取回最新的預訂詳細資料。
訊息可能不會依序送達。請參閱時間戳記以判斷順序,並取回預訂活動行程以取得更新狀態。
收到訊息後,您的整合作業必須以正確的 HTTP 狀態碼回應。通知服務會將所有未收到 200 級狀態碼的訊息,視為未傳遞且會排入重試佇列。
處理結果 | 詳細資料 | 回應狀態碼 |
---|---|---|
成功 |
|
200 |
失敗 |
|
400s |
|
500s |
無法傳遞的訊息
若無法將訊息成功傳遞至您的端點,則我們會依照以下排程自動重試:
- 5 分鐘過後進行第一次重試
- 1 小時過後進行第二次重試
- 7 天內每 12 小時執行後續重試 (共 14 次)
若我們未收到收取確認 (200 OK 狀態碼),且訊息已排入重試佇列,則您可能會收到重覆的訊息。尋找具有相同 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.