通知All Versions

概述

EPS 通知解决方案可让您比以往更紧密地与 EPS 整合。当发生可能影响您的企业的变更时，EPS 将通过标准的 POST 消息将变更详细信息直接推送到您的系统。  借助我们的推送通知，您可以了解情况、简化操作并扩大企业规模。

当前我们支持发生在 API 范围外的所有预订事件的通知。因此，如果电话服务中心做出变更或酒店取消预订，您将立即获得通知。这只是一个开始 – 我们将会推出更多通知事件类型。

通过实现与您的企业的无缝整合，这些通知可为下列 EPS 产品和服务锦上添花：

• EPS Rapid API
• 联营公司 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. 后续每隔 12 小时重试一次，持续 7 天（共 14 次）

如果我们未收到接收确认（200 OK 状态代码），并且消息排入重试队列，您可能会收到重复的消息。您可以识别重复的消息，方法是找到具有相同 event_id，但 timestamp 比原始消息晚的消息。

通知测试 API

EPS 通知测试 API 可让您将请求测试通知发送到指定的测试端点，以验证您与通知服务的整合。您也可以使用我们的通知服务测试程序将测试通知直接发送给端点，而无需建立您自己的请求。

重要说明

此服务的请求功能未向生产通知 API 提供 - 您不能将请求发送到活动端点以触发或刷新生产通知。请求通过该测试 API 提供，仅用于测试目的。

由于此 API 仅用于测试目的，其 GET 请求触发仅通过 test.ean.com 可用。

消息模式和支持的消息主题

所有测试通知遵循与生产通知相同的模式和消息主题，如通知 API 文档中所述。

整合

接收消息

要开始接收测试通知，您将需要建立一个可公开访问的 HTTPS 端点，该端点可以接受将推送到您的端点的 POST 消息。

与您的 EPS 整合顾问合作，进行设置并向其提供下列信息：

• 您要订阅的用于测试的事件主题列表（已在上面的前一部分中列出）
• 测试端点用于处理测试通知的 URL

如果您在 30 分钟请求之后无法接收测试通知，请联系您的 EPS 整合顾问，让其帮助您解决问题。

重要说明

在您收到的通知中，测试通知和生产通知之间没有区别。强烈建议您特别为测试通知设置端点，以便主动地隔离测试消息和生产消息。

如果您为测试和生产设置了不同的端点，将仅在您的测试端点收到测试通知，同样地，您只会在生产端点收到生产通知。