一、接口描述/说明
即时查询(增值版)接口
(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