一、接口描述/说明

1.即时查询(轨迹地图版)接口

（1）查询接口支持按照运单号查询(单个/批量查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8003。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

(7)免费试用快递鸟物流查询地图轨迹接口官网地址：http://www.kdniao.com/product-mapTrack1

讯享网

 请求系统级参数说明：

2.快递查询(轨迹地图版)接口

（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8004。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

请求系统级参数说明：

3.订阅(轨迹地图版)接口

（1）此功能为专业定制，为特殊商户提供订阅服务，快递鸟系统会定时推送新的物流信息到商户系统。
（2）订阅快递号需指定相应的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（4）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：https://api.kdniao.com/api/dist

请求系统级参数说明：

4.推送(轨迹地图版)接口(商户实现)

（1）客户需要按快递鸟要求开发接口，保证信息的正常接收。
（2）快递鸟主动推送时，物流信息接收接口由客户提供。
（3）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（4）运单物流信息全量推送(每次推送的运单物流信息包括运单当前所有的的物流信息)。

请求系统级参数说明：

 二、使用流程

三、接口参数

1.即时查询(轨迹地图版)接口

请求内容字段定义：

返回参数定义返回参数定义：

2.快递查询(轨迹地图版)接口

请求内容字段定义：

 返回参数定义：

3.订阅(轨迹地图版)接口

请求内容字段定义：

 返回参数定义：

4.推送(轨迹地图版)接口

应用级输入参数

订阅查询(轨迹地图版)结果（RequestType：102）

通过轨迹查询（订阅查询）接口订阅到快递鸟的数据，快递鸟推送时，会将推送的RequestType的值置为102，同时返回下列数据

请求内容字段定义:

返回参数定义

四、示例

即时查询(增值版)接口

请求示例 JSON

{ "IsReturnCoordinates":1, "OrderCode":"", "ShipperCode":"YTO", "LogisticCode":"YT85", "SenderCityName":"泉州市", "ReceiverCityName":"亳州市" }

返回示例 JSON

讯享网没有物流轨迹的{ "ReceiverCityLatAndLng" : "33.,115.", "LogisticCode" : "YT84", "ShipperCode" : "YTO", "Traces" : [ ], "State" : "0", "SenderCityLatAndLng" : "24.,118.", "EBusinessID" : "", "Reason" : "暂无轨迹信息", "Success" : true }有物流轨迹的{ "StateEx" : "2", "EstimatedDeliveryTime" : "2020-08-29 18:53:35", "PreCoordinates" : [ { "LatAndLng" : "24.,118.", "Location" : "泉州市" }, { "LatAndLng" : "32.,117.", "Location" : "蚌埠市" }, { "LatAndLng" : "33.,115.", "Location" : "亳州市" } ], "ShipperCode" : "YTO", "Traces" : [ { "Action" : "1", "AcceptStation" : "福建省泉州市德化县 揽收成功", "AcceptTime" : "2020-08-26 18:53:35", "Location" : "泉州市" }, { "Action" : "2", "AcceptStation" : "福建省泉州市德化县 已打包", "AcceptTime" : "2020-08-26 19:08:29", "Location" : "泉州市" }, { "Action" : "2", "AcceptStation" : "福建省泉州市德化县 已发出 下一站 泉州转运中心", "AcceptTime" : "2020-08-26 19:16:48", "Location" : "泉州市" }, { "Action" : "2", "AcceptStation" : "泉州转运中心 已发出 下一站 蚌埠转运中心", "AcceptTime" : "2020-08-26 21:52:38", "Location" : "蚌埠市" }, { "Action" : "2", "AcceptStation" : "蚌埠转运中心 已发出 下一站 安徽省亳州市", "AcceptTime" : "2020-08-28 03:05:43", "Location" : "亳州市" }, { "Action" : "2", "AcceptStation" : "安徽省亳州市 已收入", "AcceptTime" : "2020-08-28 11:59:43", "Location" : "亳州市" }, { "Action" : "2", "AcceptStation" : "安徽省亳州市 已收入", "AcceptTime" : "2020-08-28 11:59:43", "Location" : "亳州市" } ], "Coordinates" : [ { "LatAndLng" : "24.,118.", "Location" : "泉州市" }, { "LatAndLng" : "32.,117.", "Location" : "蚌埠市" }, { "LatAndLng" : "33.,115.", "Location" : "亳州市" } ], "EBusinessID" : "", "Success" : true, "ReceiverCityLatAndLng" : "33.,115.", "LogisticCode" : "YT85", "State" : "2", "SenderCityLatAndLng" : "24.,118.", "Location" : "亳州市", "RouteMapUrl" : "" }

快递查询(增值版)接口

请求示例 JSON

{ "IsReturnCoordinates":1, "OrderCode":"", "ShipperCode":"YTO", "LogisticCode":"YT85", "SenderCityName":"泉州市", "ReceiverCityName":"亳州市" }

返回示例 JSON

讯享网没有物流轨迹的{ "ReceiverCityLatAndLng" : "33.,115.", "LogisticCode" : "YT84", "ShipperCode" : "YTO", "Traces" : [ ], "State" : "0", "SenderCityLatAndLng" : "24.,118.", "EBusinessID" : "", "Reason" : "暂无轨迹信息", "Success" : true }有物流轨迹的{ "StateEx" : "2", "EstimatedDeliveryTime" : "2020-08-29 18:53:35", "PreCoordinates" : [ { "LatAndLng" : "24.,118.", "Location" : "泉州市" }, { "LatAndLng" : "32.,117.", "Location" : "蚌埠市" }, { "LatAndLng" : "33.,115.", "Location" : "亳州市" } ], "ShipperCode" : "YTO", "Traces" : [ { "Action" : "1", "AcceptStation" : "福建省泉州市德化县 揽收成功", "AcceptTime" : "2020-08-26 18:53:35", "Location" : "泉州市" }, { "Action" : "2", "AcceptStation" : "福建省泉州市德化县 已打包", "AcceptTime" : "2020-08-26 19:08:29", "Location" : "泉州市" }, { "Action" : "2", "AcceptStation" : "福建省泉州市德化县 已发出 下一站 泉州转运中心", "AcceptTime" : "2020-08-26 19:16:48", "Location" : "泉州市" }, { "Action" : "2", "AcceptStation" : "泉州转运中心 已发出 下一站 蚌埠转运中心", "AcceptTime" : "2020-08-26 21:52:38", "Location" : "蚌埠市" }, { "Action" : "2", "AcceptStation" : "蚌埠转运中心 已发出 下一站 安徽省亳州市", "AcceptTime" : "2020-08-28 03:05:43", "Location" : "亳州市" }, { "Action" : "2", "AcceptStation" : "安徽省亳州市 已收入", "AcceptTime" : "2020-08-28 11:59:43", "Location" : "亳州市" }, { "Action" : "2", "AcceptStation" : "安徽省亳州市 已收入", "AcceptTime" : "2020-08-28 11:59:43", "Location" : "亳州市" } ], "Coordinates" : [ { "LatAndLng" : "24.,118.", "Location" : "泉州市" }, { "LatAndLng" : "32.,117.", "Location" : "蚌埠市" }, { "LatAndLng" : "33.,115.", "Location" : "亳州市" } ], "EBusinessID" : "", "Success" : true, "ReceiverCityLatAndLng" : "33.,115.", "LogisticCode" : "YT85", "State" : "2", "SenderCityLatAndLng" : "24.,118.", "Location" : "亳州市", "RouteMapUrl" : "" }

订阅(增值版)接口

请求示例 JSON

{ "ShipperCode":"SF", "OrderCode":"SF", "LogisticCode":"76", "PayType":"1", "ExpType":"1", "CustomerName":"", "CustomerPwd":"", "MonthCode":"", "IsNotice":"0", "Sender":{ "Name":"", "Tel":"", "Mobile":"", "ProvinceName":"广东省", "CityName":"深圳市", "ExpAreaName":"福田区", "Address":"测试地址" }, "Receiver":{ "Name":"", "Tel":"", "Mobile":"", "ProvinceName":"广东省", "CityName":"深圳市", "ExpAreaName":"龙华新区", "Address":"测试地址2" }, "Commodity":[ { "GoodsName":"书本" } ], "IsReturnCoordinates": 1 }

返回示例 JSON

讯享网{ "EBusinessID":"", "UpdateTime":"2016-08-09 16:42:38", "Success":true, "Reason":"", "SenderCityLatAndLng":"113.88308,22.55329", "ReceiverCityLatAndLng":"113.88308,22.55329" }

推送接口(增值版)

请求示例 JSON[订阅查询(增值版)]

{ "EBusinessID":"", "Count":"1", "PushTime":"2016-11-03 11:54:34", "Data":[ { "EBusinessID":"", "ShipperCode":"ZTO", "LogisticCode":"0", "Success":true, "State":"2", "Traces":[ { "AcceptTime":"2016-10-28 17:54:18", "AcceptStation":"杭州钱江开发区 的 悠可1 已收件", "Location":"杭州市", "Action":"1" }, { "AcceptTime":"2016-10-28 19:10:59", "AcceptStation":"快件离开 杭州钱江开发区 已发往 上海", "Location":"杭州市", "Action":"2" }, { "AcceptTime":"2016-10-28 21:49:34", "AcceptStation":"快件已到达 杭州中转部", "Location":"杭州市", "Action":"2" }, { "AcceptTime":"2016-10-28 22:39:12", "AcceptStation":"快件离开 杭州中转部 已发往 上海", "Location":"杭州市", "Action":"2" }, { "AcceptTime":"2016-10-29 02:07:53", "AcceptStation":"快件已到达 上海航空部", "Location":"上海市", "Action":"2" }, { "AcceptTime":"2016-10-29 02:36:04", "AcceptStation":"快件离开 上海 已发往 杨浦同济", "Location":"上海市", "Action":"2" }, { "AcceptTime":"2016-10-29 03:28:29", "AcceptStation":"快件已到达 上海", "Location":"上海市", "Action":"2" }, { "AcceptTime":"2016-10-29 07:25:46", "AcceptStation":"快件已到达 杨浦同济", "Location":"上海市", "Action":"2" }, { "AcceptTime":"2016-10-29 07:27:02", "AcceptStation":"杨浦同济 的 近邻宝 正在派件", "Location":"上海市", "Action":"402" } ], "StateEx":"402", "Location":"上海市" } ] }

返回示例JSON

讯享网{ "EBusinessID":"", "UpdateTime":"2016-08-09 16:42:38", "Success":true, "Reason":"" }