该文档仅限于与代练派业务合作方接入,其他任何非法接入系统应承担相应的法律责任。
使用该文档之前请先联系代练派官方客服申请appid以及appkey。

场景介绍

适用于商户自己发布订单到本平台,并且进行已发布的订单管理。

产品流程

1.商家申请获取appid以及appkey。
2.商家开始使用发单接口进行订单发布。
3.通过查询以及额外操作进行订单管理。

⚠️注意

1.编码:UTF-8
2.请求协议:HTTPS
3.响应数据:标准JSON

⚠️测试相关参数

appid : 36117ce282754bb6b22328011e33530b
appkey : 84699B23B0DD71D32D77F618C476E95C
测试地址:pre-backend-provider.super.jiaoyimao.cn
线上地址:backend-provider.super.jiaoyimao.cn

⚠️签名算法

签名仅支持MD5方式,计算sign的输入数据为待签名字符串加上key(即:appkey),key由飞猫代练分配。在请求参数列表中,除去sign参数外, 其他需要使用到的参数均为要签名的参数。
1.生成待签名字符串:(sign以下上送值仅为示例,具体以分配的参数为准)

{
"appid": "36117ce282754bb6b22328011e33530b",
"requestId": "1564402972422",
"requestTime": "2019-07-29 08:22:52",
}

对数组里的每一个值从a到z的顺序排序(ASCII字典序),若遇到相同首字母,则看第二个字母,以此类推。排序完成之后,再把所有数组值以“&”字符连接起来,如:
appid=36117ce282754bb6b22328011e33530b&requestId=1564402972422&requestTime=2019-07-29 08:22:52
这串字符串便是待签名字符串。

⚠️ 没有值(包含空字符串)的参数无需传递,也不需包含到待签名数据中
根据HTTP协议要求,传递参数的值中如果存在特殊字符(如:&、@等),则该值需要做URL Encoding,这样请求接收方才能接收到正确的参数值。注意:这种情况下,待签名数据应该是原始值 而不是encoding之后的值。
2.签名示例:
假设key(即appkey)的值为:84699B0DD71D32D77F618C476E95C
则待签名的字符串:
appid=36117ce282754bb6b22328011e33530b&requestId=1564402972422&requestTime=2019-07-29 08:22:5284699B0DD71D32D77F618C476E95C
MD5签名:
2FA2106DB1059759BFA0F14E5B72C044

⚠️ 订单状态

orderStatusType字段说明
1待接单
2代练中
3待验收
4已验收
5异常中
6撤销中
7锁定
8已撤销
9仲裁中
10已仲裁
98已下架
99删除