开发指南


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  下单需要测试到根据取消条款进行取消下单。

5. 相关文档