推送接口地址:請和業務對接人溝通獲取
接口使用Http請求來調用,使用Post將值傳給平臺
數據統一使用utf-8編碼
數據傳參統一用json格式
參數 | 類型 | 是否必填 | 描述 | 示例值 |
data | string | 必填 | 訂單數據,json格式,支持單筆和批量推送訂單,參考data數據結構 | {"orders":[{data數據結構},{data數據結構}]} |
appkey | string | 必填 | 應用編號 | 438b2f6ff103422a98a9349507293bb2 |
token | string | 必填 | 訪問令牌 | 9415c33b04d24c7dae320b0185f42fb0 |
timestamp | string | 必填 | 時間戳 | 2018-08-15 12:23:32 |
sign | string | 必填 | 簽名串 | 3d4cb71b7da597a1da8268a62270dcea |
sign簽名的規則:將請求參數中除sign以外的參數按照參數名稱進行字典排序,然后將“參數名+參數值”拼接成一個字符串,再將菠蘿派后臺生成的密鑰appsecret放到首尾,組合成一個字符串后,轉小寫,在用Md5加密成32位字符串(UTF8格式),即為sign的值。
組合示例:appsecret+appkey+appkey值+data+data值+timestamp+timestamp值+token+token值+appsecret
可參考菠蘿派商城簽名算法:http://polyapi.com/Help/PlatDesc/polysign
data數據結構可參考以下文檔:
參數 | 類型 | 描述 | 示例值 |
Code | string | 返回碼,10000代表成功,40000代表失敗 | 10000 |
Message | string | 返回信息說明 | 部分或全部失敗 |
OrderErrors | OrderError[] | 訂單錯誤信息集合 | |
ErrorCode | string | 錯訂單誤代碼(10001:訂單已遞交;10002:創建訂單失敗; 10003:遞交訂單失敗;10004:其他錯誤) | 10001 |
ErrorMessage | string | 訂單錯誤消息 | 訂單已遞交 |
OrderNO | string | 訂單號 | 201705262058354310 |
{
"Code":10000,
"Message":"SUCCESS",
"OrderErrors":[]
}
{
"Code":40000,
"Message":"部分或全部失敗,詳情見明細",
"OrderErrors":[
{
"ErrorCode":10001,
"ErrorMessage":"訂單已遞交",
"OrderNO":"201705262058354310"
},
{
"ErrorCode":10003,
"ErrorMessage":"訂單遞交失敗",
"OrderNO":"201705262058354311"
}
]
}