一、接口描述/说明
即时查询(增值版)接口
(1)查询接口支持按照运单号查询(单个查询)。
(2)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。
如:EMS物流单号应选择快递公司编码(EMS)
(3)返回的物流跟踪信息按照发生的时间升序排列。
(4)接口指令8001。
(5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
(6)接口地址: API测试地址:http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
API正式地址:http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
快递鸟在途监控API
二、接口参数
即时查询(增值版)接口
请求内容字段定义:
| 参数名称 | 类型 | 说明 | 必须要求 |
|---|---|---|---|
| OrderCode | String | 订单编号 | O |
| ShipperCode | String | 快递公司编码 | R |
| LogisticCode | String | 物流单号 | R |
返回参数定义:
| 参数名称 | 类型 | 说明 | 必须要求 |
|---|---|---|---|
| EBusinessID | String | 用户ID | R |
| OrderCode | String | 订单编号 | O |
| ShipperCode | String | 快递公司编码 | R |
| LogisticCode | String | 物流运单号 | O |
| Success | Bool | 成功与否 | R |
| Reason | String | 失败原因 | O |
| State | String | 物流状态:2-在途中,3-签收,4-问题件 | R |
| StateEx | String | 增值物流状态: 1-已揽收, 2-在途中, 201-到达派件城市, 202-派件中, 211-已放入快递柜或驿站, 3-已签收, 311-已取出快递柜或驿站, 4-问题件, 401-发货无信息, 402-超时未签收, 403-超时未更新, 404-拒收(退件), 412-快递柜或驿站超时未取 | R |
| Location | String | 增值所在城市 | R |
| Traces | |||
| AcceptTime | String | 时间 | R |
| AcceptStation | String | 描述 | R |
| Location | String | 当前城市 | O |
| Action | String | 当前状态 | O |
| Remark | String | 备注 | O |
三、JSON请求及返回
请求
{
"OrderCode": "",
"ShipperCode": "QFKD",
"LogisticCode": "390141793061"
}返回
没有物流轨迹的{
"EBusinessID":"1261585",
"Traces":[],
"OrderCode":"",
"ShipperCode":"QFKD",
"LogisticCode":"390141793061",
"Success":false,
"Reason":null
}有物流轨迹的{
"EBusinessID":"1261585",
"ShipperCode":"QFKD",
"Success":true,
"LogisticCode":"390141793061",
"State":"3",
"StateEx":"3",
"Location":"威海市",
"Traces":[
{
"AcceptTime":"2016-10-26 18:31:38",
"AcceptStation":"【北京环铁站】的【互优图书】已收件",
"Location":"北京市",
"Action":"1"
},
{
"AcceptTime":"2016-10-26 19:53:50",
"AcceptStation":"快件在【北京环铁站】装车,正发往【北京分拨中心】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-26 21:00:13",
"AcceptStation":"快件到达【北京分拨中心】,上一站是【北京环铁站】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-26 21:06:27",
"AcceptStation":"快件在【北京分拨中心】装车,正发往【青州分拨中心】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 11:04:43",
"AcceptStation":"快件到达【北京分拨中心】,上一站是【】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 13:04:43",
"AcceptStation":"快件在【北京分拨中心】装车,正发往【青州分拨中心】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 20:06:03",
"AcceptStation":"快件到达【青州分拨中心】,上一站是【】",
"Location":"潍坊市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 22:06:03",
"AcceptStation":"快件在【青州分拨中心】装车,正发往【威海】",
"Location":"潍坊市",
"Action":"2"
},
{
"AcceptTime":"2016-10-28 09:53:53",
"AcceptStation":"快件到达【威海】,上一站是【青州分拨中心】",
"Location":"威海市",
"Action":"2"
},
{
"AcceptTime":"2016-10-28 10:44:39",
"AcceptStation":"快件到达【威海】,上一站是【青州分拨中心】",
"Location":"威海市",
"Action":"2"
},
{
"AcceptTime":"2016-10-28 10:48:03",
"AcceptStation":"【威海】的【王奕凯】正在派件",
"Location":"威海市",
"Action":"202"
},
{
"AcceptTime":"2016-10-28 18:09:45",
"AcceptStation":"已签收,签收人是【毕森】,签收网点是【威海】",
"Location":"威海市",
"Action":"3"
}
]
}原文地址:http://11798217.blog.51cto.com/11788217/1880083