Developer Hub
这是自动生成的译文

试试我们的 Java 快速 SDK! 它可以简化上线流程,帮助您更快地使用 Rapid。

开始使用 Rapid API

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

设置您的 Rapid API 实现

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

第一步:成为合作伙伴

要与 Rapid API 集成,您需要 申请成为合伙人 如果你还不是其中一员的话。

步骤 2:审查适用的发射要求

查看您计划实现的 API 的启动要求,以确定哪些要求需要前端用户界面开发,以便您可以将其纳入您的项目计划中。

步骤 3:准备环境

请查阅您计划实现的每个 API 的文档,以便为使用 Rapid 做好环境准备。

步骤 4:获取凭据并配置身份验证

成为合作伙伴并获得与 Rapid API 集成的批准后,您需要获取您的 API 密钥。您可以通过登录门户网站并单击左侧菜单栏中的连接来完成此操作。然后,从选项中选择 API 密钥。您还需要共享密钥,您可以通过进入门户网站并导航到 API 密钥页面来访问该密钥。在您的网站审核通过之前,您的 API 密钥将处于受限开发模式,审核通过后方可上线生产环境。

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

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

步骤 5:开始测试您的请求

收到凭据并配置身份验证后,即可开始向我们的测试端点发出请求https://test.ean.com/。针对 https://test.ean.com/ 所提出的任何预订请求均不会产生实际住宿订单或信用卡收费。您可以从每个 API 文档中记录的测试标头中进行选择,以控制您想要看到的响应类型。如果您在任何 booking-related 请求中省略测试标头,测试服务器将为您添加一个。

使用 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 服务的版本号对应。

关于快速住宿 API 的说明: 为了确保我们提供稳定且可维护的服务,我们实施了速率限制。系统会监控异常的 API 流量并自动采取措施来保护服务。在对 API 调用行为进行任何计划更改之前,或者使用 API 访问进行性能测试之前,请务必与您的 Rapid API 顾问审查您的计划。

步骤 6:请求现场审查

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


Warning

警告

如果在切换到 https://api.ean.com后收到 403 Forbidden 响应,请通知您的业务发展经理,并要求他们验证您的 API 密钥是否已为生产端点启用。Rapid 将不会针对我们的生产端点授权开发 API 密钥。

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

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

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

您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!