常用快递物流轨迹查询api接口调用哪种好?

 快递鸟物流查询API接口提供包括顺丰、京东、圆通、韵达、中通、EMS、极兔、德邦、安能、宅急送、跨越、联邦、UPS、DHL等国内外1600+物流快递公司单号查询。自动识别快递公司及单号，服务器毫秒响应，数据及时准确。专人维护，随时畅快沟通。

并且所有产品提供API在线测试，适不适合试试就知道，致力于为开发者更大程度地减轻负担。

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

（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

 

 

一、接口描述/说明

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）运单物流信息全量推送(每次推送的运单物流信息包括运单当前所有的的物流信息)。

 

 二、使用流程

 

 

 

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

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

请求内容字段定义:

 

示例

即时查询(增值版)接口

请求示例 JSON

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

返回示例 JSON

没有物流轨迹的

{
"ReceiverCityLatAndLng" : "33.8764100,115.7791400",
"LogisticCode" : "YT9259962006184",
"ShipperCode" : "YTO",
"Traces" : [ ],
"State" : "0",
"SenderCityLatAndLng" : "24.8894600,118.6130000",
"EBusinessID" : "1305585",
"Reason" : "暂无轨迹信息",
"Success" : true
}

有物流轨迹的

{
"StateEx" : "2",
"EstimatedDeliveryTime" : "2020-08-29 18:53:35",
"PreCoordinates" : [ {
"LatAndLng" : "24.8894600,118.6130000",
"Location" : "泉州市"
}, {
"LatAndLng" : "32.9444800,117.3677900",
"Location" : "蚌埠市"
}, {
"LatAndLng" : "33.8764100,115.7791400",
"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.8894600,118.6130000",
"Location" : "泉州市"
}, {
"LatAndLng" : "32.9444800,117.3677900",
"Location" : "蚌埠市"
}, {
"LatAndLng" : "33.8764100,115.7791400",
"Location" : "亳州市"
} ],
"EBusinessID" : "1305585",
"Success" : true,
"ReceiverCityLatAndLng" : "33.8764100,115.7791400",
"LogisticCode" : "YT9259962006185",
"State" : "2",
"SenderCityLatAndLng" : "24.8894600,118.6130000",
"Location" : "亳州市",
"RouteMapUrl" : ""
}

 

快递查询(增值版)接口

请求示例 JSON

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

返回示例 JSON

没有物流轨迹的

{
"ReceiverCityLatAndLng" : "33.8764100,115.7791400",
"LogisticCode" : "YT9259962006184",
"ShipperCode" : "YTO",
"Traces" : [ ],
"State" : "0",
"SenderCityLatAndLng" : "24.8894600,118.6130000",
"EBusinessID" : "1305585",
"Reason" : "暂无轨迹信息",
"Success" : true
}

有物流轨迹的

{
"StateEx" : "2",
"EstimatedDeliveryTime" : "2020-08-29 18:53:35",
"PreCoordinates" : [ {
"LatAndLng" : "24.8894600,118.6130000",
"Location" : "泉州市"
}, {
"LatAndLng" : "32.9444800,117.3677900",
"Location" : "蚌埠市"
}, {
"LatAndLng" : "33.8764100,115.7791400",
"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.8894600,118.6130000",
"Location" : "泉州市"
}, {
"LatAndLng" : "32.9444800,117.3677900",
"Location" : "蚌埠市"
}, {
"LatAndLng" : "33.8764100,115.7791400",
"Location" : "亳州市"
} ],
"EBusinessID" : "1305585",
"Success" : true,
"ReceiverCityLatAndLng" : "33.8764100,115.7791400",
"LogisticCode" : "YT9259962006185",
"State" : "2",
"SenderCityLatAndLng" : "24.8894600,118.6130000",
"Location" : "亳州市",
"RouteMapUrl" : ""
}

订阅(增值版)接口

请求示例 JSON

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

返回示例 JSON

{
"EBusinessID":"1151847",
"UpdateTime":"2016-08-09 16:42:38",
"Success":true,
"Reason":"",
"SenderCityLatAndLng":"113.88308,22.55329",
"ReceiverCityLatAndLng":"113.88308,22.55329"
}
推送接口(增值版)

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

{
"EBusinessID":"1261585",
"Count":"1",
"PushTime":"2016-11-03 11:54:34",
"Data":[
{
"EBusinessID":"1261585",
"ShipperCode":"ZTO",
"LogisticCode":"416071867790",
"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":"1261585",
"UpdateTime":"2016-08-09 16:42:38",
"Success":true,
"Reason":""
}

 

posted @ 2022-03-28 15:31  爱程序的小猿  阅读(581)  评论(0)  编辑  收藏  举报