请求地址
POST
请求头
名称 | 类型 | 默认值 |
---|---|---|
Content-Type | string | application/x-www-form-urlencoded |
请求体
名称 | 是否必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 贵司提供给快递100 |
num | 是 | string | 运单号 |
sign | 是 | string | 32位大写,MD5 ( key+ num + secret)的顺序进行加密,不需要加上“+”号,secret和key由贵司提供给快递100 |
响应数据
名称 | 是否必填 | 类型 | 说明 |
---|---|---|---|
result | 是 | boolean | 请求结果 |
message | 是 | string | |
state | 是 | string | 轨迹当前状态,如:0在途,1揽收,2疑难,3签收,4退签,5派件,6退回,7转单,10待清关,11清关中,12已清关,13清关异常,14收件人拒签等 |
Θdata | 是 | array | 物流轨迹 |
└context | 是 | string | 节点轨迹描述 |
└location | 否 | string | 节点位置 |
└time | 是 | string | 节点时间,必须格式化为yyyy-mm-dd hh:mm:ss |
接口描述
实时获取运单轨迹
编码:UTF-8
一、请求失败:
{
"result": false,
"message": "验签失败",
"data": []
}
二、请求成功,没有物流轨迹:
{
"result": true,
"message": "运单号不存在",
"data": []
}
三、请求成功,有物流轨迹:
{
"result": true,
"message": "SUCCESS",
"state":0,
"data": [
{
"context": "站点【退货部】进行了【货物退回客户扫描】操作",
"location": "",
"time": "2018-04-29 16:31:48"
},
{
"context": "快件到达【退货部】,上一站是【北京分拣中心】",
"location": "",
"time": "2018-04-03 14:26:25"
},
{
"context": "快件离开【北京分拣中心】,发往【C应急二】",
"location": "",
"time": "2018-03-07 01:21:28"
},
{
"context": "【北京分拣中心】收件入库,交货方是【快乐购北京】",
"location": "北京",
"time": "2018-03-07 00:55:26"
}
]
}
官方文档:
https://api.kuaidi100.com/document/60509213a52d305ab4d2a1cb.html