Rapid 入门

Rapid 入门很简单。只需获得 API 密钥和共享秘钥，然后配置 Rapid 身份验证，即可开始测试。

1. 成为合作伙伴

要与 Rapid 集成，您需要申请成为合作伙伴（如果您还不是的话）。

2. 查看适用于您的网站的上线要求

查看上线要求，以决定哪些要求需要前端 UI 开发，并将其纳入您的项目规划。

• B2B 单独预订
• B2C 单独预订

3. 准备环境

查看这些资源，为使用 Rapid 准备环境。

• 如何运作
• 处理预订请求
• 构建取消政策

4. 获取凭据并配置 Rapid 身份验证

成为合作伙伴并获准与 Rapid 集成后，您需要获取 API 密钥。您可以在登录 EPS 门户网站后点击左侧菜单栏中的直连。然后，从选项中选择 API 密钥。您将看到当前 API 密钥详细信息。

API 密钥是 Rapid 签名身份验证系统所需的两个密钥凭据之一。您还需要您的共享秘钥，您可以通过访问 EPS 门户网站并前往 API 密钥页面来获取。您的 API 密钥将处于受限开发模式，直到您的网站在通过审核后获准发布到生产环境。

要请求使用我们的 API 服务（无论是处于测试还是生产环境中），您将使用 HTTP 授权标头传输每个请求的 API 密钥以及 SHA-512 签名哈希值。SHA-512 哈希值包含您的共享秘钥、API 密钥以及当前的 UNIX 时间戳。Rapid 授权标头始终使用下列格式：

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

请查看我们的签名身份验证页面上的详细信息。您可以使用我们的签名生成器工具生成 SHA-512 哈希值，以针对您的集成进行测试。

5. 开始测试您的请求

在收到凭据并配置 Rapid 身份验证之后，您可以针对我们的测试端点 https://test.ean.com/ 提出请求。针对 https://test.ean.com/ 所提出的任何预订请求均不会产生实际住宿订单或信用卡收费。您可以选择使用我们文档中记录的测试标头，以便预订 API 能够控制您想看到的响应类型，或者如果您在任何预订相关请求中省略了测试标头，则测试服务器将会自动为您添加一个标头。

**重要提示：**为了确保向所有合作伙伴提供稳定且便于维护的服务，我们对速率做了限制。系统会监控异常的 API 流量并自动采取措施来保护服务。在对调用 API 的行为进行任何计划内变更或对 API 访问进行性能测试之前，请务必与您的 Rapid 顾问一起检查您的计划。

指定您的 API 版本

请使用 OpenAPI 规范中的 servers.url 值来构建 URL。test.ean.com 用于验证您的集成，api.ean.com 是生产端点。请在端点之间切换时保留协议和路径。

https://test.ean.com/v3/itineraries?… https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

servers.url 值位于可下载的 OpenAPI 规范文件顶部，并且始终与给定 API 服务的版本号对应。

示例：OpenAPI 规范

openapi: 3.0.1
info:
  title: Rapid
  description: EPS Rapid V3
  version: v3
servers:
  - url: https://test.ean.com/v3

6. 请求对网站进行审核

在对集成感到满意且已确认您满足适用的上线要求后，请业务拓展经理对网站进行审核。获准上线后，业务拓展经理会为您启用生产环境所需的 API 密钥。只需将您的请求端点从 https://test.ean.com/ 切换到 https://api.ean.com 并继续提出请求，无需进行其他代码变更。