該文檔僅限于與代練派業務合作方接入,其他任何非法接入系統應承擔相應的法律責任。
使用該文檔之前請先聯系代練派官方客服申請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 | 刪除 |