java物流查詢軌跡地圖快遞鳥API接口案例代碼
一、接口描述/說明
1.即時查詢(軌跡地圖版)接口
（1）查詢接口支持按照運單號查詢(單個/批量查詢)。
（2）接口需要指定快遞單號的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的信息。
如：EMS物流單號應(yīng)選擇快遞公司編碼（EMS）查看快遞公司編碼
（3）返回的物流跟蹤信息按照發(fā)生的時間升序排列。
（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)免費試用快遞鳥物流查詢地圖軌跡接口官網(wǎng)地址：http://www.kdniao.com/product-mapTrack1
?請求系統(tǒng)級參數(shù)說明：
2.快遞查詢(軌跡地圖版)接口
（1）查詢接口支持按照運單號查詢(單個查詢)。
（2）接口需要指定快遞單號的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的信息。
如：EMS物流單號應(yīng)選擇快遞公司編碼（EMS）查看快遞公司編碼
（3）返回的物流跟蹤信息按照發(fā)生的時間升序排列。
（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
請求系統(tǒng)級參數(shù)說明：
3.訂閱(軌跡地圖版)接口
（1）此功能為專業(yè)定制，為特殊商戶提供訂閱服務(wù)，快遞鳥系統(tǒng)會定時推送新的物流信息到商戶系統(tǒng)。
（2）訂閱快遞號需指定相應(yīng)的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的信息。
如：EMS物流單號應(yīng)選擇快遞公司編碼（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
請求系統(tǒng)級參數(shù)說明：
4.推送(軌跡地圖版)接口(商戶實現(xiàn))
（1）客戶需要按快遞鳥要求開發(fā)接口，保證信息的正常接收。
（2）快遞鳥主動推送時，物流信息接收接口由客戶提供。
（3）接口支持的消息接收方式為HTTP POST，請求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（4）運單物流信息全量推送(每次推送的運單物流信息包括運單當(dāng)前所有的的物流信息)。
請求系統(tǒng)級參數(shù)說明：
?二、使用流程
三、接口參數(shù)
1.即時查詢(軌跡地圖版)接口
請求內(nèi)容字段定義：
返回參數(shù)定義返回參數(shù)定義：
2.快遞查詢(軌跡地圖版)接口
請求內(nèi)容字段定義：
?返回參數(shù)定義：
3.訂閱(軌跡地圖版)接口
請求內(nèi)容字段定義：
?返回參數(shù)定義：
4.推送(軌跡地圖版)接口
應(yīng)用級輸入?yún)?shù)
訂閱查詢(軌跡地圖版)結(jié)果（RequestType：102）
通過軌跡查詢（訂閱查詢）接口訂閱到快遞鳥的數(shù)據(jù)，快遞鳥推送時，會將推送的RequestType的值置為102，同時返回下列數(shù)據(jù)
請求內(nèi)容字段定義:
返回參數(shù)定義
?
四、示例
即時查詢(增值版)接口
請求示例 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" : "福建省泉州市德化縣 已發(fā)出 下一站 泉州轉(zhuǎn)運中心",
? ? ? ?"AcceptTime" : "2020-08-26 19:16:48",
? ? ? ?"Location" : "泉州市"
? ?}, {
? ? ? ?"Action" : "2",
? ? ? ?"AcceptStation" : "泉州轉(zhuǎn)運中心 已發(fā)出 下一站 蚌埠轉(zhuǎn)運中心",
? ? ? ?"AcceptTime" : "2020-08-26 21:52:38",
? ? ? ?"Location" : "蚌埠市"
? ?}, {
? ? ? ?"Action" : "2",
? ? ? ?"AcceptStation" : "蚌埠轉(zhuǎn)運中心 已發(fā)出 下一站 安徽省亳州市",
? ? ? ?"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" : "福建省泉州市德化縣 已發(fā)出 下一站 泉州轉(zhuǎn)運中心",
? ? ? ?"AcceptTime" : "2020-08-26 19:16:48",
? ? ? ?"Location" : "泉州市"
? ?}, {
? ? ? ?"Action" : "2",
? ? ? ?"AcceptStation" : "泉州轉(zhuǎn)運中心 已發(fā)出 下一站 蚌埠轉(zhuǎn)運中心",
? ? ? ?"AcceptTime" : "2020-08-26 21:52:38",
? ? ? ?"Location" : "蚌埠市"
? ?}, {
? ? ? ?"Action" : "2",
? ? ? ?"AcceptStation" : "蚌埠轉(zhuǎn)運中心 已發(fā)出 下一站 安徽省亳州市",
? ? ? ?"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":"福田區(qū)",
? ? ? ?"Address":"測試地址"
? ?},
? ?"Receiver":{
? ? ? ?"Name":"1255760",
? ? ? ?"Tel":"",
? ? ? ?"Mobile":"13800000000",
? ? ? ?"ProvinceName":"廣東省",
? ? ? ?"CityName":"深圳市",
? ? ? ?"ExpAreaName":"龍華新區(qū)",
? ? ? ?"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":"杭州錢江開發(fā)區(qū) 的 悠可1 已收件",
? ? ? ? ? ? ? ? ? ?"Location":"杭州市",
? ? ? ? ? ? ? ? ? ?"Action":"1"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-28 19:10:59",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件離開 杭州錢江開發(fā)區(qū) 已發(fā)往 上海",
? ? ? ? ? ? ? ? ? ?"Location":"杭州市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-28 21:49:34",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件已到達(dá) 杭州中轉(zhuǎn)部",
? ? ? ? ? ? ? ? ? ?"Location":"杭州市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-28 22:39:12",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件離開 杭州中轉(zhuǎn)部 已發(fā)往 上海",
? ? ? ? ? ? ? ? ? ?"Location":"杭州市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-29 02:07:53",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件已到達(dá) 上海航空部",
? ? ? ? ? ? ? ? ? ?"Location":"上海市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-29 02:36:04",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件離開 上海 已發(fā)往 楊浦同濟(jì)",
? ? ? ? ? ? ? ? ? ?"Location":"上海市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-29 03:28:29",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件已到達(dá) 上海",
? ? ? ? ? ? ? ? ? ?"Location":"上海市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-29 07:25:46",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"快件已到達(dá) 楊浦同濟(jì)",
? ? ? ? ? ? ? ? ? ?"Location":"上海市",
? ? ? ? ? ? ? ? ? ?"Action":"2"
? ? ? ? ? ? ? ?},
? ? ? ? ? ? ? ?{
? ? ? ? ? ? ? ? ? ?"AcceptTime":"2016-10-29 07:27:02",
? ? ? ? ? ? ? ? ? ?"AcceptStation":"楊浦同濟(jì) 的 近鄰寶 正在派件",
? ? ? ? ? ? ? ? ? ?"Location":"上海市",
? ? ? ? ? ? ? ? ? ?"Action":"402"
? ? ? ? ? ? ? ?}
? ? ? ? ? ?],
? ? ? ? ? ?"StateEx":"402",
? ? ? ? ? ?"Location":"上海市"
? ? ? ?}
? ?]
}
返回示例JSON
{
? ?"EBusinessID":"1261585",
? ?"UpdateTime":"2016-08-09 16:42:38",
? ?"Success":true,
? ?"Reason":""
}
