1.需要在阿里开放平台(https://open.taobao.com/),注册appKey;
2.需要使用appKey和appSecret访问;
3.接口仅支持https协议,以post请求访问;
4.SDK调用试例地址: https://open.taobao.com/docV3.htm?spm=a219a.7386653.0.0.7aa5669aaJixbr&docId=101618&docType=1
5.接口后(TOP)代表系统商可以通过TOP平台进行消息回调。
6.飞猪调用系统商的接口,需要做幂等。
7.线上回调地址:https://eco.taobao.com/router/rest
预发回调地址:https://pre-gw.api.taobao.com/top/router/rest(联调测试过程中使用预发回调地址)
字段 | 类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
Content-Type | String | 是 | 固定值 plication/json | |
accessKey | String | 是 | 账号 | |
timestamp | String | 是 | 时间戳毫秒值 | |
sign | String | 是 | 加密签名 | MD5(JSON.toJSONString(请求参数)+accessKey+accessSecret+timestamp) |
注:accessSecret是账号信息对应的秘钥;accessKey和accessSecret系统商自定义生成
JSON.toJSONString(请求参数),以JSON形式请求
商品接口 | 变更说明 | 时间 |
---|---|---|
4.4、4.5 | 去除上架、下架,目前暂不支持 | 2022-06-27 |
4.5 | 新增必填字段mode,酒店通兑能力 | 2022-07-03 |
4.4 | 新增startDate、endDate俩个非必填字段 | 2022-07-04 |
4.1、4.2、4.3 | 返回参数model改为data | 2022-07-04 |
4.4、4.5 | top接口去除字段描述,以开放平台为准 | 2022-07-08 |
4.1、4.2、4.3 | code字段描述改为返回码 0-success | 2022-08-05 |
订单接口 | 变更说明 | 时间 |
---|---|---|
2.5 | 添加非必填字段refundRefusedReason | 2022-06-27 |
2.4 | 创单返回参数由飞猪订单号改为对接方订单id | 2022-07-01 |
2.4 | 返回参数vouchers字段类型由list改为list<HotelTicketVoucher> | 2022-07-03 |
2.7 | 修改status和failMsg说明 | 2022-07-03 |
2.2、2.4、2.5、2.6 | 返回参数model改为data | 2022-07-04 |
2.7、2.8、2.9 | top接口去除字段描述,以开放平台为准 | 2022-07-08 |