java物流查询轨迹地图快递鸟API接口案例代码

一、接口描述/说明

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)免费试用快递鸟物流查询地图轨迹接口官网地址：物流查询地图版API_快递物流监控接口_快递鸟物流轨迹查询API接口

请求系统级参数说明：

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":"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":""
}

java物流查询轨迹地图快递鸟API接口案例代码相关推荐

顺丰快递单号查询接口物流路由跟踪信息快递鸟api对接教程
目录 1.完成前期准备工作 2.API接口 3.请求参数(Headers) 4.请求参数(Body) 5.返回参数(Return) 6.请求完整报文(示例) 7.成功返回报文(示例) 8.失败返回报文 ...
众邮快递单号查询快递鸟API接口-众邮快递ZYE
前言看完快递鸟api众邮快递对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成众邮快递接口对接.到达众邮快递官网界面显示的效果,更适合刚入门的菜鸟,调用快递鸟的众邮快递查询API接口,能查询 ...
极兔快递单号查询快递鸟API接口对接指南-极兔速递
目录 1.完成前期准备工作 2.API接口 3.请求参数(Headers) 4.请求参数(Body) 5.返回参数(Return) 6.请求完整报文(示例) 7.成功返回报文(示例) 8.失败返回报文 ...
快递接口API：用JS调用快递鸟API接口进行快递单号查询
本文实例为大家分享了JS调用快递鸟API接口,来实现600多家的物流轨迹查询,完成快递单号查询的具体代码,供大家参考,具体内容如下只需要一步,新建一个Text文本,把下面这段代码复制进去,替换你自己 ...
如何使用快递鸟API接口查询物流轨迹信息？
近年来,我国电商产业发展迅速,数据显示,2010-2019年,我国电子商务交易规模从4.55万亿元增长至了34.81万亿元,年均复合增速达25%.在电子商务蓬勃发展的态势下,我国电商物流行业也迎来了广 ...
物流一站式单号查询之快递鸟API接口（附Demo源码）
前三篇中,我们已经从注册.申请接口.调用接口.联调开发.部署上线等一系列角度对比过几家不同的物流平台,今天我们再来瞧一瞧快递鸟这个物流API平台,我们会今天从全流程的快速梳理一遍,另外,我还会就在我对 ...
快递鸟API接口技术规范说明文档
快递鸟 API 旨在为电商.电商平台.物流工具.打单工具.仓储系统.移动 APP 等系统提供专业.稳定.优质的 API 接口服务,满足不同用户的物流管理需求. 本文档就各个 API 接口进行详细说明, ...
快递鸟物流查询轨迹地图API接口案例代码java
一.接口描述/说明 1.即时查询(轨迹地图版)接口 (1)查询接口支持按照运单号查询(单个/批量查询). (2)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息. 如:EMS物 ...
JAVA快递单号查询接口对接第三方快递鸟api接口教程
应用场景: 1.网站用户后台的订单页面,用户打开页面时先调用快递接口查询这个用户的订单的快递,然后将结果显示在页面中: 2.内部快速搜索,用户打电话过来只要问对方的名字,然后直接搜到这个用户的订单的快 ...

java物流查询轨迹地图快递鸟API接口案例代码

java物流查询轨迹地图快递鸟API接口案例代码相关推荐

最新文章

热门文章