快递鸟API对接文档之 即时查询(地图版)

快递鸟
48 阅读7分钟

功能说明

向快递公司实时查询物流轨迹信息，在地图上直观地展示包裹的位置和预计送达时间点击图片访问设计图 接口信息

RequestType 接口指令

8003

批量请求

不支持，并发不超过 20次/S

计费规则

40 天内同物流编码+同单号不限查询次数，计算使用1单。返回无轨迹不计费

轨迹排序

按照发生时间的升序排列

接口地址

​​https://api.kdniao.com/api/dist​​

💡如果您第一次使用快递鸟，请参考​​接口规范​​ 请求示例 应用级参数

名称

类型(长度)

是否必须

描述

ShipperCode

String(10)

​​《快递公司编码》​​

LogisticCode

String(30)

快递单号

CustomerName

String(50)

顺丰必填跨越必填中通必填

寄件人or收件人 手机号后四位尽量使用寄件人尾号顺丰可能用虚拟号下单录入系统 作为验证标准后四位传值错误无法获取到顺丰轨迹（可能拉取缓存）顺丰/中通后四位正确性可通过微信小程序【顺丰速运+】验证中通仅支持查询签收后6个月内的单号

菜鸟橙运

菜鸟货主编号

Sort

Int(1)

轨迹按时间排序，0-升序，1-降序，默认0

OrderCode

String(30)

订单编号

Receiver.ProvinceName

String(20)

收件省(如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等；如是自治区，请直接传广西壮族自治区等)

Receiver.CityName

String(20)

收件市(如深圳市，不要缺少“市；如是市辖区，请直接传北京市、上海市等”)

Receiver.ExpAreaName

String(20)

收件区/县 (如福田区，不要缺少“区”或“县”)

Receiver.Address

String(100)

收件人详细地址 (不用传省市区)

Sender.ProvinceName

String(20)

发件省(如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等；如是自治区，请直接传广西壮族自治区等)

Sender.CityName

String(20)

发件市(如深圳市，不要缺少“市；如是市辖区，请直接传北京市、上海市等”)

Sender.ExpAreaName

String(20)

发件区/县 (如福田区，不要缺少“区”或“县”)

Sender.Address

String(100)

发件人详细地址 (不用传省市区)

IsReturnCoordinates

Int

是否返回城市经纬度1：返回，2：不返回，默认1

IsReturnRouteMap

Int

是否返回轨迹地图1：返回，2：不返回，默认2

💡若未提供收寄件地址，则地图精度精确到市级（同城件不支持显示），建议提供地址以提升查询精度 返回参数当接口返回无轨迹时请参考下表中的物流状态和返回reason进行处理

名称

类型(字符长度)

是否必须

描述

EBusinessID

String(10)

用户ID

ShipperCode

String(10)

​​快递公司编码​​

LogisticCode

String(30)

快递单号

Success

Bool(10)

成功与否(true/false)

Reason

String(50)

失败原因

State

String(5)

​​普通物流状态（点击查看）​​

StateEx

String(5)

​​详细物流状态（点击查看）​​

Location

String(20)

当前城市

Traces.AcceptTime

String(32)

轨迹发生时间，示例：2021-01-01 09:00:00

Traces.AcceptStation

String(500)

轨迹描述

Traces.Location

String(20)

历史节点所在城市

Traces.Action

String(50)

同 StateEx

SenderCityLatAndLng

String(50)

发件城市经纬度

ReceiverCityLatAndLng

String(50)

收件城市经纬度

Coordinates.LatAndLng

String(50)

途经城市经纬度

PreCoordinates.Location

String(50)

预设路径经过城市

PreCoordinates.LatAndLng

String(50)

预设路径城市经纬度

EstimatedDeliveryTime

String(32)

订单预计到达时间，示例：2021-01-01 09:00:00请求时传收发双方地址，返回此值该预计时间取值于静态库，仅供基础参考，需要更准确的预计时间功能请参考​​预计送达时间​​

RouteMapUrl

String(1000)

轨迹地图URL生效条件：IsReturnRouteMap=1地图链接有效期：30 天

Traces.Remark

String(20)

备注

OrderCode

String(30)

订单编号

Callback

String(50)

用户自定义回传字段

CityIsNull

Bool(10)

预留备用字段

Station

String(50)

派件网点的名称

StationTel

String(50)

派件网点的电话

DeliveryMan

String(50)

派件快递员

DeliveryManTel

String(50)

派件快递员手机号

NextCity

String(50)

下一站城市

RouteMapUrlCode

String(50)

无意义 忽略

轨迹返回示例

{

"StateEx": "302",

"PreCoordinates": [],

"ShipperCode": "ZTO",

"Traces": [{

"Action": "1",

"AcceptStation": "【沧州市】 沧州肃宁县（0317-3*1）肃宁中通（155*0） 已揽收",

"AcceptTime": "2025-01-09 19:22:16",

"Location": "沧州市"

}, {

"Action": "1",

"AcceptStation": "【沧州市】【沧州肃宁县】(0317-3*1)的业务员肃宁中通(1551*0)已揽收",

"AcceptTime": "2025-01-09 19:22:16",

"Location": "沧州市"

}, {

"Action": "2",

"AcceptStation": "【沧州市】 快件已发往 襄樊转运中心",

"AcceptTime": "2025-01-09 19:22:25",

"Location": "沧州市"

}, {

"Action": "2",

"AcceptStation": "【沧州市】快件离开【沧州肃宁县】发往襄樊转运中心",

"AcceptTime": "2025-01-09 19:22:25",

"Location": "沧州市"

}, {

"Action": "204",

"AcceptStation": "【沧州市】 快件已到达 沧衡转运中心",

"AcceptTime": "2025-01-09 22:18:34",

"Location": "沧州市"

}, {

"Action": "2",

"AcceptStation": "【沧州市】 快件已发往 武汉转运中心",

"AcceptTime": "2025-01-09 22:21:49",

"Location": "沧州市"

}, {

"Action": "2",

"AcceptStation": "【沧州市】快件离开【沧衡转运中心】发往武汉转运中心",

"AcceptTime": "2025-01-09 22:21:49",

"Location": "沧州市"

}, {

"Action": "204",

"AcceptStation": "【武汉市】 快件已到达 武汉转运中心",

"AcceptTime": "2025-01-10 23:53:28",

"Location": "武汉市"

}, {

"Action": "2",

"AcceptStation": "【武汉市】 快件已发往 襄樊转运中心",

"AcceptTime": "2025-01-11 00:01:55",

"Location": "武汉市"

}, {

"Action": "2",

"AcceptStation": "【武汉市】快件离开【武汉转运中心】发往襄樊转运中心",

"AcceptTime": "2025-01-11 00:01:55",

"Location": "武汉市"

}, {

"Action": "204",

"AcceptStation": "【襄阳市】 快件已到达 襄樊转运中心",

"AcceptTime": "2025-01-11 05:39:44",

"Location": "襄阳市"

}, {

"Action": "2",

"AcceptStation": "【襄阳市】 快件已发往 襄阳襄州西",

"AcceptTime": "2025-01-11 05:48:46",

"Location": "襄阳市"

}, {

"Action": "2",

"AcceptStation": "【襄阳市】快件离开【襄樊转运中心】发往襄阳襄州西",

"AcceptTime": "2025-01-11 05:48:46",

"Location": "襄阳市"

}, {

"Action": "2",

"AcceptStation": "【襄阳市】 快件已到达 襄阳襄州西",

"AcceptTime": "2025-01-11 07:44:27",

"Location": "襄阳市"

}, {

"Action": "202",

"AcceptStation": "【襄阳市】襄阳襄州西 的业务员【张婷,138*7】正在为您派件（95720为中通快递员外呼专属号码，请放心接听，如有问题可联系网点:0710-3*6,投诉电话:186*1）",

"AcceptTime": "2025-01-11 07:44:28",

"Location": "襄阳市"

}, {

"Action": "202",

"AcceptStation": "【襄阳市】【襄阳襄州西】（0710-3*6）的业务员张婷（138*7）正在派件【95720为中通快递员外呼专属号码，请放心接听】！",

"AcceptTime": "2025-01-11 07:44:28",

"Location": "襄阳市"

}, {

"Action": "211",

"AcceptStation": "【襄阳市】 快件已在 菜鸟 的【襄阳星悦里店】暂放，【取件地址：汉津路26号（进英大酒店旁）】，请及时取件。如有疑问请联系业务员：1388*7，代理点电话：1830*3，投诉电话：186*1",

"AcceptTime": "2025-01-11 09:10:47",

"Location": "襄阳市"

}, {

"Action": "412",

"AcceptStation": "【襄阳市】快件已投递【襄阳星悦里店】，如有问题请电联 (0710-3*6)，感谢使用中通快递，期待再次为您服务！",

"AcceptTime": "2025-01-11 09:10:47",

"Location": "襄阳市"

}, {

"Action": "302",

"AcceptStation": "【襄阳市】 您的快递已签收，签收人在【襄阳星悦里店】取件。如有疑问请联系业务员：138*7，代理点电话：183*3，投诉电话：186*1。感谢使用中通快递，期待再次为您服务！",

"AcceptTime": "2025-01-14 18:23:15",

"Location": "襄阳市"

}],

"Coordinates": [{

"LatAndLng": "38.3140400,116.8663800",

"Location": "沧州市"

}, {

"LatAndLng": "30.5820300,114.0291900",

"Location": "武汉市"

}, {

"LatAndLng": "32.0448700,112.1355500",

"Location": "襄阳市"

}],

"EBusinessID": "1000000",

"RouteMapUrlCode": "7cd9dd7ab519346f934747bd592f4e9f4cb45233c9f79a961b0bcece9143efc9",

"CityIsNull": true,

"DeliveryManTel": "1388*1",

"Success": true,

"ReceiverCityLatAndLng": "32.0448700,112.1355500",

"RouteMapUrl": "track.kdniao.com/#/result?co…",

"LogisticCode": "78474409893076",

"State": "3",

"SenderCityLatAndLng": "38.3140400,116.8663800",

"Location": "襄阳市"

}

avatar
文章
阅读
粉丝