该文档仅限于与代练派业务合作方接入,其他任何非法接入系统应承担相应的法律责任。
使用该文档之前请先联系代练派官方客服申请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 | 删除 |