提交订单获取任务接口
POST
https://api.kuaidi100.com/ent/order/task用户提交指定时间范围内的订单获取任务,快递100根据时间范围拆分出多个订单获取的任务列表,返回任务列表给用户。后续快递100会根据任务列表获取订单信息,任务获取结束后会把获取结果推送到用户的回调地址中。 任务列表中,每个任务查询失败,隔5分钟后重试,连续3次重试都失败则会终止查询并且推送一条queryStatus=Abort的消息告知用户。
parma数据结构:
参数名称 | 数据类型 | 是否必填 | 参数描述 |
---|---|---|---|
shopType | string | 是 | 店铺类型,若使用淘宝店铺,填入:TAOBAO |
shopId | string | 是 | 店铺ID |
orderStatus | string | 是 | 订单状态,UNPAY:未付款;UNSHIP:待发货(默认值);SHIPED:等待卖家确认收货;FINISH:交易成功/完成;CLOSE:交易关闭/取消 |
updateAtMin | string | 是 | 订单更新的最小时间,格式:yyyy-MM-dd HH:mm:ss |
updateAtMax | string | 是 | 订单更新的最大时间,格式:yyyy-MM-dd HH:mm:ss |
callbackUrl | string | 否 | 回调地址 |
salt | string | 是 | 回调参数sign的加密参数,非空时回调才会有sign参数 |
请求参数
Body 参数application/x-www-form-urlencoded
key
string
必需
授权码,请申请企业版获取
sign
string
必需
32位大写,签名,用于验证身份,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号
parma
string
由其他参数拼接
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
必需
提交结果。true表示成功
returnCode
integer
返回编码
message
string
返回报文描述
data
object
业务数据
total
integer
任务总数
tasks
array [object {3}]
任务类别
示例
{
"result": true,
"returnCode": 200,
"message": "SUCCESS",
"data": {
"total": 2,
"tasks": [
{
"taskId": "61a8b60a9ac14514bd854318ac9a53ab",
"updateAtMin": "2021-11-12 16:00:00",
"updateAtMax": "2021-11-12 16:30:00"
},
{
"taskId": "94261f0d24c54c34a6552584a0dd4197",
"updateAtMin": "2021-11-12 16:30:00",
"updateAtMax": "2021-11-12 17:00:00"
}
]
}
}
最后修改时间: 3 years ago