通知

概覽

EPS 通知解決方案可讓您更緊密地與 EPS 整合。若發生可能影響您業務的變更，EPS 會利用標準 POST 訊息，直接將變更詳細資料推播至您的系統。  推播通知可讓您隨時接收最新資訊、簡化操作以及調整業務範圍。

我們目前支援在 API 外部發生的所有預訂活動通知。因此，若客戶服務中心發生變更或飯店取消預訂，您便會立即收到通知。這只是開始，很快地我們會支援更多通知活動類型。

這些通知功能與您的業務無縫整合後，可強化下列 EPS 產品與服務：

• EPS Rapid API
• Affiliate Voyager 服務專員預訂工具
• 合作夥伴與客戶服務

新工具我們現在為所有「通知」支援的活動類型提供「測試 API」。請查看下方的下一個主要區段瞭解詳細資訊。若您想要設定自己的要求，您也可以使用我們全新的「通知測試」工具。

支援的訊息類型

EPS 通知可將下列活動的通知訊息傳送到您的系統：

訊息結構描述與詳細資料

所有訊息皆採用下方概述的結構描述。系統會針對不同活動新增訊息類型，因此結構描述可能有異。

支援的訊息主題

每則訊息皆為訊息本文為 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 級狀態碼的訊息，視為未傳遞且會排入重試佇列。

無法傳遞的訊息

若無法將訊息成功傳遞至您的端點，則我們會依照以下排程自動重試：

1. 5 分鐘過後進行第一次重試
2. 1 小時過後進行第二次重試
3. 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 整合顧問，協助您解決問題。

重要備註

在您收到的通知中，測試通知和產品通知不會有任何差別。我們強烈建議您為測試通知設定指定的端點，以正確分別測試與產品訊息。

為測試與產品設定不同端點時，您在測試端點只會收到測試通知，而同樣地，在產品端點也只會收到產品通知。