

物流快递查询 API 如何对接？

杭州数勋科技有限公司

2025-11-17

导读：物流快递查询 API 接口是一种允许不同软件应用程序之间进行通信和数据交换，以获取快递物流信息的应用程序接口，它将物流快递公司的信息系统与其他需要查询物流信息的应用系统连接起来，通过规定的通信协议和数

物流快递查询 API 接口是一种允许不同软件应用程序之间进行通信和数据交换，以获取快递物流信息的应用程序接口，它将物流快递公司的信息系统与其他需要查询物流信息的应用系统（如电商平台、企业内部管理系统等）连接起来，通过规定的通信协议和数据格式，实现数据的交互和共享。

通过这个接口，应用程序可以按照预先定义好的规则，向物流快递公司的信息系统发送查询请求。这些请求通常包含与快递包裹相关的特定标识，如快递单号、订单号等。物流快递公司的信息系统在接收到请求后，会根据这些标识进行检索，并将对应的物流信息，如包裹的当前位置、运输状态、预计送达时间等，按照规定的格式返回给发起请求的应用程序。然后，应用程序再将这些信息以直观、易懂的方式呈现给用户，让用户能够实时跟踪自己包裹的运输情况。

那么接下来我们来聊一聊怎么对接物流快递查询 API。

首先我们找到一家有物流快递查询 API 接口的服务商，如数勋API,注册账号，购买免费套餐：

然后让我们技术把物流快递查询 API对接到系统中，数勋API支持多种编程语言对接，下面以java为例：

package com.shuxun.data.impl.demo;import com.shuxun.common.core.util.HttpUtil;import org.apache.commons.codec.digest.DigestUtils;import java.util.HashMap;import java.util.Map;public class ExpressQueryDemo {    private static final String APP_KEY = "您的appKey";    private static final String APP_SECRET = "您的appSecret";    private static final String API_URL = "https://api.shuxuntech.com/v1/express/query";    public static void main(String[] args) {        String timestamp = System.currentTimeMillis()+"";        String sign = DigestUtils.sha256Hex(APP_KEY + timestamp + APP_SECRET);        Map<String, String> header = new HashMap<>(4);        header.put("appKey", APP_KEY);        header.put("timestamp", timestamp);        header.put("sign", sign);        Map<String, String> params = new HashMap<>(2);        // 快递编号        params.put("no", "");        // 快递代码        params.put("code", "");        // 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位        params.put("tel", "");        // 工具类下载地址 https://file.shuxuntech.com/other/code/util.zip        String result = HttpUtil.get(API_URL, header, params);        System.out.println("返回结果="+result);    }}

对接好后输入快递单号和快递代号查询实时物流信息。该接口支持单号自动识别，可查询国内外上千家物流快递公司的物流跟踪服务，包括顺丰、圆通、申通、中通、韵达、百世、EMS等快递物流查询，同步支持物流轨迹查询功能。返回示例如下：

正确返回：

{
"code":"0",
"msg":"成功",
"isFee":1,
"seqNo":"8bdguy0kbojrkq9cf5tp3l4tidbpile3",
"data":{
"theLastTime":"2024-02-28 13:47:43",//运单号物流流转当前最新描述
"cpCode":"EMS",//快递公司编码
"mailNo":"985834***141",//快递单号
"cpMobile":"11183",//快递公司电话
"theLastMessage":"您的快件已签收【***理工学院软件学院东菜鸟驿站】，如有疑问请电联快递员【电话:157***5502】。连接美好，无处不在，感谢您使用中国邮政，期待再次为您服务。",//运单号物流流转当前最新描述
"logisticsCompanyName":"EMS",//快递公司名称
"cpUrl":"https://www.ems.com.cn/",//快递公司官网
"takeTime":"2天3小时50分",//从揽收到送达所耗时间
"logisticsStatusDesc":"已签收",//运单号当前物流状态文字描述
"logisticsTraceDetailList":[//物流流转明细
{
"areaCode":"CN***00000000",//非必须，当前节点所在地址行政编码
"areaName":"河南省,**市",//非必须，当前节点所在地区，省,市,区或省,市
"subLogisticsStatus":"SIGN",//物流流转子状态，详见：物流状态编码对照表
"time":1709099263000,//时间,单位毫秒
"logisticsStatus":"SIGN",//物流流转状态，详见：物流状态编码对照表
"desc":"您的快件已签收【***理工学院软件学院东菜鸟驿站】，如有疑问请电联快递员【电话:157***5502】。连接美好，无处不在，感谢您使用中国邮政，期待再次为您服务。"//物流流转描述
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,**市",
"subLogisticsStatus":"STA_INBOUND",
"time":1709098104000,
"logisticsStatus":"DELIVERING",
"desc":"您的快件已派送至【***理工学院软件学院东菜鸟驿站】，自提点电话:153***0902，请您凭取件码领取快件，如有疑问请电联快递员【电话:15737715502】，投诉请致电11183。"
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,南阳市",
"subLogisticsStatus":"DELIVERING",
"time":1709084792000,
"logisticsStatus":"DELIVERING",
"desc":"快件正在派送中，请耐心等待，保持电话畅通，准备签收，如有疑问请电联快递员【苗**，电话:157***5502】或揽投部【电话:0377-631***00】，投诉请致电11183。"
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,**市",
"subLogisticsStatus":"TRANSPORT",
"time":1709084492000,
"logisticsStatus":"TRANSPORT",
"desc":"快件到达【***市白河揽投部】"
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,南阳市",
"subLogisticsStatus":"TRANSPORT",
"time":1709074003000,
"logisticsStatus":"TRANSPORT",
"desc":"快件离开【**市包件车间】，正在发往下一站"
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,**市",
"subLogisticsStatus":"TRANSPORT",
"time":1709058177000,
"logisticsStatus":"TRANSPORT",
"desc":"快件到达【**市包件车间】"
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,***市",
"subLogisticsStatus":"TRANSPORT",
"time":1709036234000,
"logisticsStatus":"TRANSPORT",
"desc":"快件离开【***市包件车间】，正在发往下一站"
},
{
"areaCode":"CN***00000000",
"areaName":"河南省,***市",
"subLogisticsStatus":"TRANSPORT",
"time":1709032670000,
"logisticsStatus":"TRANSPORT",
"desc":"快件到达【***市包件车间】"
},
{
"areaCode":"CN5***00000000",
"areaName":"四川省,***市",
"subLogisticsStatus":"TRANSPORT",
"time":1708962186000,
"logisticsStatus":"TRANSPORT",
"desc":"快件离开【**双流处理中心天府包件车间】，正在发往下一站"
},
{
"areaCode":"CN5***00000000",
"areaName":"四川省,***市",
"subLogisticsStatus":"TRANSPORT",
"time":1708952075000,
"logisticsStatus":"TRANSPORT",
"desc":"快件到达【***双流处理中心天府包件车间】"
},
{
"areaName":"四川省,**市,**县",
"subLogisticsStatus":"TRANSPORT",
"time":1708952067000,
"logisticsStatus":"TRANSPORT",
"desc":"快件离开【**区电商客户平岗路揽投部】，正在发往【成都双流处理中心天府包件车间】"
},
{
"areaName":"四川省,成都市,**县",
"subLogisticsStatus":"TRANSPORT",
"time":1708952066000,
"logisticsStatus":"TRANSPORT",
"desc":"快件已在【**区电商客户平岗路揽投部】完成分拣，准备发出"
},
{
"areaCode":"CN5***00000000",
"areaName":"四川省,成都市",
"subLogisticsStatus":"ACCEPT",
"time":1708911453000,
"logisticsStatus":"ACCEPT",
"desc":"中国邮政 已收取快件"
}
],
"logisticsStatus":"SIGN"//物流流转状态，详见：物流状态编码对照表;
}
}