一、接口介绍

接口目的本文描述了

库存 API 接口的实现方案。合作商可以通过 API 方式实现酒店房型等基本信息的查询及落地；酒店的每 日最低报价查询及落地；实时查询酒店的产品售卖信息；试预订及下单，订单取消，订单查询，信用额度查询，订单状态同步等 功能。

接口地址格式

每个不同的 API 均提供不同的请求地址。每次请求均需使用如下格式生成完整请求地址：  示例格式地址联系商务提供  请求时采用 post 方式，Content-Type 为：application/json，其中{}参数分别代表如下内容： {API_URL}：所需请求的 API 访问地址。 正式生产环境 联系商务提供  测试环境请求地址 联系商务提供  接口信息表中对应的接口名称。 请求报文为一份规范的对应请求格式的请求值内容，具体内容格式因逻辑、业务而不同，通用格式请参考 下一部分，具体格式请参考 API 接口详细部分。

请求方式：POST

报文格式：JSON

频次限制：各接口频率默认是100次/min

在线调试平台

合作商通过此平台，可以在线自助化进行开发调试，在真实生产环境中，进行酒店信息获取，实时报价查 询，订单处理等各环节模拟操作。

当需要操作创建订单接口或订单支付接口时，请提前通知对接人员。

二、对接步骤

详细流程详解

1.获取落地静态数据

红色加力为合作商提供了一整套完整的静态数据获取接口，合作商可通过静态数据接口获取到红色加力的国家、城市、行政区、商业 区等信息，再通过城市信息获取酒店 id 列表信息。获取到酒店 id 列表信息后，合作商根据酒店 id 获取酒店的基本信息进行落 地。同时可以通过酒店图片接口获取酒店的图片的地址，图片地址分 HTTP URL 地址和 FTP 路径地址两种。如果合作商需要将 图片落地到本地，可以根据图片的 FTP 路径地址向红色加力获取 FTP 账号后进行下载。

2.获取酒店房型增量信息

合作商需要定时通过酒店增量查询接口定期拉取有变更的酒店 id，然后根据酒店 id 同步酒店房型数据。变更的数据包括酒店房 型基本信息的新增删除修改及酒店房型的图片变更。

3.获取酒店每日起价信息

为方便合作商查询展示售卖酒店，红色加力提供了酒店 30 天内的每日起价查询接口供合作商落地起价数据。并且红色加力每天都会 对酒店 30 天内的每日最低起价进行计算更新，合作商需要每天拉取一次最新的起价信息进行更新。

4.实时查询酒店产品信息

通过起价接口合作商只能获取到酒店的最低起价信息，当点击酒店进入酒店详情页查看酒店产品时，合作商需要调用酒店实时产 品查询接口实时查询酒店的最新售卖信息。

5.酒店预订

当点击酒店的可预订按钮进行酒店预订时，合作商需要调用试预订接口，红色加力会对该产品进行是否可订校验，当返回可订，客 户填写好订单信息提交订单时需要再次调用试预订接口，返回可订时合作商才能调用创建订单接口进行下单操作。创建订单成功 后，此时订单为待支付状态，合作商需要调用支付接口进行支付，支付成功后，红色加力才会对该订单进行确认操作，此时合作商 需要等待红色加力的订单确认推送后才能将订单确认给客户。

6.订单确认

合作商支付订单成功后，红色加力会对订单进行确认，然后通过订单状态推送接口将结果通知给合作商。合作商拿到订单确认结果 后确认给客户。合作商也可通过订单查询接口主动获取订单的状态。

7.订单取消

当客户需要取消订单，合作商调用订单取消接口，如果此订单为待支付状态，红色加力会直接返回取消成功，如果此订单为已支付 状态，红色加力会对订单的取消条款进行校验，然后返回取消结果。 开发步骤有任何疑问请随时联系红色加力。

8.联调要求

测试联调：含试预订、创建订单、支付、确认订单、取消订单等接口均需测试

红色加力指定测试酒店如下：

酒店：城市=塔城，酒店名=泰坦塔城测试酒店；

测试单客户名称一律为中文的“测试”，即客人姓测名试。