开发指南
1. 开发步骤
- 1.1 贵方联系捷旅销售客服,提供接入意向,获取测试的域名和账号。
- 1.2 参考平台上标准开发文档,进行开发,可以边开发边测试。
- 1.3 测试通过后,按要求用最终正式数据测试一次,准备上线。
2. 接口要求
- 2.1 报价接口:最大支持qps:20。
- 2.2 变价接口:建议每1分钟轮询一次。
- 2.3 变价增量接口更新:根据贵司需要缓存天数,更新对应天报价;
- 2.4 接口需要开启gzip,请求里带accept-encoding: gzip, deflate,get请求需要做urlencode。
- 2.5 对接正式环境必须提供所有服务器IP,以便捷旅进行路由和白名单控制。
- 2.5 单个订单包含多晚时,预订和取消规则取最严格那一天的。
3. 接口使用流程
- 3.1 开发城市列表接口,获取地区信息。
- 3.2 开发酒店列表接口,获取酒店信息(该接口数据只支持酒店简单信息)。
- 3.3 开发静态数据详情接口,获取酒店详情、房型、价格类型、图片等信息;
- 3.4 开发报价接口,获取价格、房态、库存、预订条款、取消条款等信息。
- 3.5 开发变价增量接口,获取变化id和变价范围,在调用报价接口获取价格。
- 3.6 开发订单报价接口,检验价格、房态、库存。
- 3.7 开发下单接口,下单成功后返回订单号。
- 3.8 开发查询订单接口,获取订单状态与确认号。
- 3.9 开发取消订单接口,取消订单。
4. 订单测试步骤
- 4.1 先在测试环境查询报价接口,获取价格、房态、库存。
- 4.2 调用订单报价接口,通过后进行下单测试。
- 4.3 下单需要测试到根据预订条款进行下单。
- 4.4 下单需要测试到根据取消条款进行取消下单。