Your EPS account
Sign in to view secure API documentation, update your account details, log support requests and much more.
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
- 联营公司 Voyager 客服预订工具
- 合作伙伴和客户支持服务
新工具现在我们面向通知支持的所有事件类型提供测试 API。请在下面的下一主要部分中查看完整的详细信息。如果您不希望设置自己的请求，也可以使用我们的全新通知测试程序工具。
支持的消息类型
EPS 通知可以借助下列事件消息向您的系统发送通知：
| 来源 | 事件 | 详细信息 |
|---|---|---|
| 客户支持客服或联营公司 Voyager | 预订创建 | EPS 客户支持客服或联营公司 Voyager 创建了一个新预订。 |
预订更新 |
EPS 客户支持客服或联营公司 Voyager 更新了一个现有预订。 |
|
| 预订取消 | EPS 客户支持客服或联营公司 Voyager 取消了一个现有预订。 | |
| 酒店 | 预订取消 | 酒店取消了一个现有预订。 客户应与您的企业的客户支持联系。 |
| Expedia | 预订取消 |
Expedia 取消了一个现有预订，因为该预订不符合适用于交易的条款和/或条件。 客户将需要发送邮件至 transactionprocessing@travelscape.com 进行联系，并提供电话号码以及最适合讨论取消事宜的时间。 |
消息模式和详细信息
所有消息均符合下面概述的模式。由于针对不同的事件添加了新消息类型，该模式可能会有所不同。
| 对象 | 说明 |
|---|---|
event_id |
每个消息的唯一标识符 |
event_type |
指示导致发送通知的事件。 此值可用于消息处理和路由。 有关详细信息，请参考事件类型列表。 |
event_time |
事件通知的时间戳 (UTC) |
itinerary_id |
受影响预订的行程 ID |
email |
与受影响行程关联的客户邮箱地址。 |
message |
事件通知的描述 |
affiliate_reference_id |
受影响预订的关联公司参考 ID |
支持的消息主题
| 来源 | 事件 | event_type 值 |
|---|---|---|
| 客户支持客服或联营公司 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 小时后重试
- 后续每隔 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 整合顾问，让其帮助您解决问题。
重要说明
在您收到的通知中，测试通知和生产通知之间没有区别。强烈建议您特别为测试通知设置端点，以便主动地隔离测试消息和生产消息。
如果您为测试和生产设置了不同的端点，将仅在您的测试端点收到测试通知，同样地，您只会在生产端点收到生产通知。