快递公司接入快递100实时查询接口
请求地址
POST
http://xx.com/api/query
请求头
| 名称 | 类型 | 默认值 |
|---|---|---|
| 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"
}
]
}
