开始使用 Rapid API

您可以自行搭建 Rapid API，也可以与经过认证的 third-party 合作伙伴合作，推出您的定制旅行网站。

设置您的 Rapid API 实现

与任何 API 一样，在使用 Rapid API 之前，您需要做一些准备工作。

第 1 步，成为合作伙伴

要与 Rapid API 集成，如果您还不是合作伙伴，则需要申请成为合作伙伴。

第 2 步，请查看我们的网站上线要求，并找出适用于您网站的相关要求。

审查产品发布需求，确定哪些需求需要前端用户界面开发，并将此因素纳入项目规划中。

住宿 API

汽车 API

B2B 或 B2C

第 3 步，准备环境

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

第 4 步，获取凭据并配置快速身份验证

成为合作伙伴并获得与 Rapid API 集成的批准后，您需要获取您的 API 密钥。您可以通过登录门户，然后点击左侧菜单栏中的连接来完成此操作。然后，从选项中选择 API 密钥。门户网站将显示您当前的 API 密钥详细信息。

API 密钥是签名认证所需的两个关键凭证之一。您还需要您的共享密钥，您可以通过进入门户并导航到 API 密钥页面来访问它。您的 API 密钥将处于受限开发模式，直到您的网站在通过审核后获准发布到生产环境。

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

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

请访问我们的签名认证页面查看完整详情。您可以使用我们的签名生成器工具生成 SHA-512 哈希值，以针对您的集成进行测试。

第 5 步：开始测试您的请求

收到凭证并配置好身份验证后，您就可以开始向我们的测试端点发出请求了，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即可继续发出请求，无需进行其他代码更改。

警告

如果您在切换到 https://api.ean.com 后收到 403 禁止访问响应，请告知您的业务拓展经理并让其确认是否已为您启用生产端点所需的 API 密钥。Rapid 将不会针对我们的生产端点授权开发 API 密钥。

与我们认证的技术合作伙伴之一合作

您是否更倾向于将快速住宿 API 开发外包？您可以与我们的精英级和优选级技术合作伙伴合作，他们可以设计、构建和优化您的集成，从而让您更快地上线，减少内部开发工作。

了解我们的认证技术合作伙伴计划