推送接口地址:请和业务对接人沟通获取
接口使用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"
}
]
}