
物流快递查询
企业用户实名使用个人用户实名使用个人用户无法使用
输入快递单号和快递代号查询实时物流信息。该接口支持单号自动识别,可查询国内外上千家物流快递公司的物流跟踪服务,包括顺丰、圆通、申通、中通、韵达、百世、EMS等快递物流查询,同步支持物流轨迹查询功能。
价格
¥0元/10次
新用户免费体验,自购买起有效期1个月
选择套餐:

接口名称:全国快递物流查询
描述:输入快递编号等信息,实时查询物流轨迹信息
请求地址 url:https://api.shuxuntech.com/v1/express/query
请求方式 method:get/post
参数:
| 名称 | 参数位置 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|
| appKey | head | string | 是 | 数勋分配appKey |
| timestamp | head | string | 是 | unix时间毫秒值 |
| sign | head | string | 是 | 签名,说明 |
| no | query | string | 是 | 快递编号 |
| code | query | string | 否 | 快递代码,详见物流快递代码字典 |
| tel | query | string | 否 | 顺丰速运/丰网速运/跨越速运需传入收件人或寄件人手机号或手机号后四位(推荐使用寄件人) |
签名算法说明:
数勋分配的appKey、当前unix时间毫秒值timestamp、数勋分配的appSecret、 按顺序拼接sha256加密得到sign,查看如下示例
appKey = aaa;
timestamp = 1682476904289;
appSecret = bbb;
sign = sha256(appKey+timestamp+appSecret)
正确返回:
{
"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" //物流流转状态,详见:物流状态编码对照表;
}
}
错误返回:
{
"code": "1",
"msg": "请输入快递编号",
"isFee": 0,
"seqNo": null,
"data": null
}
返回字段描述:
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | string | 错误码 |
| msg | string | 错误描述 |
| isFee | int | 是否计费(1:计费,0:不计费) |
| seqNo | string | 调用流水号 |
| data | object | 返回数据 |
data对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| theLastTime | string | 运单号物流流转当前最新变更时间 |
| cpCode | string | 快递公司代码 |
| mailNo | string | 快递编号 |
| cpMobile | string | 快递公司电话 |
| theLastMessage | string | 运单号物流流转当前最新描述 |
| logisticsCompanyName | string | 分快递公司名称 |
| cpUrl | string | 快递公司官网 |
| takeTime | string | 从揽收到送达所耗时间 |
| logisticsStatusDesc | string | 运单号当前物流状态文字描述 |
| logisticsStatus | string | 物流流转状态,详见:物流状态编码对照表 |
| logisticsTraceDetailList | array | 物流流转明细 |
logisticsTraceDetailList 对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| areaCode | string | 非必须,当前节点所在地址行政编码 |
| areaName | string | 非必须,当前节点所在地区,省,市,区或省,市 |
| subLogisticsStatus | string | 物流流转子状态,详见:物流状态编码对照表 |
| time | string | 时间,单位毫秒 |
| logisticsStatus | string | 物流流转状态,详见:物流状态编码对照表 |
| desc | string | 物流流转描述 |
code错误码说明
| code | 说明 |
|---|---|
| 0 | 成功 |
| 1 | 参数错误 |
| 2 | 无记录 |
| 3 | 第三方服务异常 |
| 4 | 签名错误 |
| 5 | 余额不足 |
| 6 | 调用频率超限 |
| 7 | 账号停用 |
| 8 | 接口已停用 |
| 9 | 联系服务商开通接口权限 |
| 10 | ip不在白名单 |
| 11 | 系统异常 |
| 12 | 实名状态错误 |
| 99 | 其他异常,具体返回为准 |
快递公司代码对照表
| 序号 | 值 | 描述 |
|---|---|---|
| 1 | SF | 顺丰快递 |
| 2 | YTO | 圆通快递 |
| 3 | ZTO | 中通快递 |
| 4 | YUNDA | 韵达快递 |
| 5 | YDKY | 韵达快运 |
| 6 | STO | 申通快递 |
| 7 | TTKDEX | 天天快递 |
| 8 | JD | 京东快递 |
| 9 | EMS | 中国邮政(其他常用名称:邮政国内小包、EMS、邮政标准快递、E邮宝、EMS经济快递、EMS特快专递、邮政快递包裹、EMS快递包裹、邮政EMS速递、邮政平邮、邮政商务小包、平邮、邮包、邮政快递,都可以使用此对照关系查询或订阅物流) |
| 10 | DBKD | 德邦快递 |
| 11 | DBL | 德邦物流 |
| 12 | DBKY | 德邦快运 |
| 13 | SURE | 速尔快运 |
| 14 | UC | 优速快递 |
| 15 | JT | 极兔速递 |
| 16 | KYE | 跨越速运 |
| 17 | CP471906 | 顺心捷达 |
| 18 | ANE56 | 安能物流 |
| 19 | BESTQJT | 百世快运 |
| 20 | FW | 丰网速递 |
| 21 | YMDD | 壹米滴答 |
| 22 | JYM | 加运美 |
| 23 | ZTOKY | 中通快运 |
| 24 | CP449455 | 京广速递 |
| 25 | ZJS | 宅急送 |
| 26 | FAST | 快捷快递 |
| 27 | FEDEX | 联邦快递 |
| 28 | RRS | 日日顺 |
| 29 | SNWL | 苏宁快递 |
| 30 | ZMKM | 丹鸟 |
| 31 | ZMKMKD | 丹鸟快递 |
| 32 | RFD | 如风达 |
| 33 | YCKY | 远成快运 |
| 34 | JYXP | 九曳供应链 |
| 35 | CP468398 | 圆通承诺达 |
| 36 | GTO | 国通快递 |
| 37 | QFKD | 全峰快递 |
| 38 | SDSD | 山东递速 |
| 39 | XFWL | 信丰物流 |
| 40 | CP443514 | 百世云配 |
| 41 | LE10032270 | 韵达同城 |
| 42 | PADTF | 平安达腾飞 |
| 43 | HOAU | 天地华宇 |
| 44 | STOKY | 申通快运 |
| 45 | ZTKY | 中铁物流/飞豹快递 |
| 46 | EWINSHINE | 万象物流 |
| 47 | QRT | 全日通 |
| 48 | GZFY | 凡宇快递 |
| 49 | XBWL | 新邦物流 |
| 50 | CRE | 中铁快运 |
| 51 | LTS | 联昊通 |
| 52 | SHENGHUI | 盛辉物流 |
| 53 | HUANGMAJIA | 黄马甲配送 |
| 54 | CHENGBANG | 晟邦物流 |
| 55 | GZLT | 飞远配送 |
| 56 | HZABC | 飞远(爱彼西)配送 |
| 57 | YCT | 黑猫宅急便 |
| 58 | COE | COE |
| 59 | DTW | 大田物流 |
| 60 | AIR | 亚风速递 |
| 61 | WJ | 万家物流 |
| 62 | D4PX | 递四方 |
| 63 | UPS | UPS |
| 64 | SUIJIAWL | 穗佳物流 |
| 65 | SUTENG | 速腾快递 |
| 66 | ANNTO | 安得智联 |
| 67 | DISU | D速 |
| 68 | ZZJHTD | 郑州建华 |
| 69 | ZTOGJ | 中通国际 |
| 70 | SXJH | 建华快递 |
| 71 | ZL | 四川增联供应链 |
| 72 | JUSDA | 准时达 |
| 73 | YDGJ | 韵达国际 |
| 74 | FENGNIAO | 蜂鸟配送 |
| 75 | FJGJ | 泛捷国际物流 |
| 76 | CVP | 潮优配 |
| 77 | LSWL | 林氏物流 |
| 78 | CQLY | 重庆铃宇消费品供应链 |
| 79 | XINZHIHUI | 新智慧 |
| 80 | STOINTL | 申通国际 |
| 81 | HBZL | 湖北众联 |
| 82 | GOODKUAIDI | GOOD快递 |
| 83 | EWE_GLOBAL | EWE GLOBAL |
| 84 | WDSWL | 鸿达顺物流 |
| 85 | AXD | 安鲜达 |
| 86 | GDNFCMFXWL | 广东南方传媒发行物流 |
| 87 | XLOBO | 贝海国际速递 |
| 88 | ESDEX | 卓志速运 |
| 89 | YTOGJ | 圆通国际 |
| 90 | STWL | 速通物流 |
| 91 | WAJ | 沃埃家 |
| 92 | UBON | 优邦速运 |
| 93 | WND | WnDirect |
| 94 | SXXF | 山西馨富 |
| 95 | YC | 远长物流 |
| 96 | BSGJ | 百世国际 |
| 97 | YUD | 长发快递 |
| 98 | KMYRX | 昆明云瑞祥 |
| 99 | DHL | DHL全球 |
| 100 | CN7000001011758 | 泰进物流 |
| 101 | BYZH | 贝业智慧物流 |
| 102 | JQWL | 浙江鉴强物流 |
| 103 | ESB | E速宝 |
| 104 | SZXK | 苏州熙康 |
| 105 | DDS | 点点送 |
| 106 | SUYUN123 | 58速运 |
| 107 | SEND2CHINA | Send2China |
| 108 | CYEXP | 长宇快递 |
| 109 | TTKEU | 天天欧洲物流 |
| 110 | SQWL | 商桥物流 |
| 111 | WORLDCPS | 天马物流 |
| 112 | KXTX | 卡行天下 |
| 113 | AOYOUZGKY | 澳邮中国快运 |
| 114 | EFS | EFSPOST |
| 115 | AXWL | 安迅物流 |
| 116 | RUSTON | 俄速通 |
| 117 | PAKD | 平安快递 |
| 118 | TDWL_123456 | 腾达物流 |
| 119 | XZB | 鑫泽邦物流 |
| 120 | HCT | 新竹物流 |
| 121 | MGSD | 美国速递 |
| 122 | SCJXWLYXGS | 余氏东风 |
| 123 | DD | 当当宅配 |
| 124 | AST | 安世通 |
| 125 | FTDKD | 富腾达快递 |
| 126 | EHAOYAO | 好药师物流 |
| 127 | RBYZEMS | 日本邮政EMS |
| 128 | CGKD | 程光快递 |
| 129 | DOD | 门对门 |
| 130 | YDTKD | 易达通快递 |
| 131 | BHWL | 保宏物流 |
| 132 | XAJ | 新安居仓配 |
| 133 | CSZX | 城市之星 |
| 134 | XYWL | 秀驿物流 |
| 135 | LTJZPS | 蓝豚家装配送 |
| 136 | DJ56 | 东骏快捷 |
| 137 | NEDA | 能达速递 |
| 138 | CHS | 重庆中环 |
| 139 | YXWLJT | 宇鑫物流 |
物流状态对照表

全国物流快递查询
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);
}
}
import requests
import time
import hashlib
appKey = "您的appKey"
appSecret = "您的appSecret"
url = "https://api.shuxuntech.com/v1/express/query"
method = 'POST'
time = time.time()
timestamp = str(round(time * 1000))
print (timestamp)
tmp = appKey + timestamp + appSecret
sign = hashlib.sha256(tmp.encode("utf8")).hexdigest()
headers = {
'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
'appKey': appKey
'timestamp': timestamp
'sign': sign
}
params = {}
params['no'] = ''
params['code'] = ''
params['tel'] = ''
response = requests.post(url, data = params, headers = headers)
print (response.text)
<?php
$appKey = "您的appKey";
$appSecret= "您的appSecret";
$url = "https://api.shuxuntech.com/v1/express/query";
$method = "POST";
$timestamp = getUnixTimestamp();
var_dump($timestamp);
$sign = hash('sha256',$appKey . $timestamp . $appSecret);
var_dump($sign);
$headers = array();
array_push($headers, "Content-Type" . ":" . "application/x-www-form-urlencoded; charset=UTF-8");
array_push($headers, "appKey" . ":" . $appKey);
array_push($headers, "timestamp" . ":" . $timestamp);
array_push($headers, "sign" . ":" . $sign);
$no = "";
$code = "";
$tel = "";
$bodys = "no=" . $no . "&code=" . $code . "&tel=" . $tel;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
if (1 == strpos("$".$url, "https://")) {
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
var_dump(curl_exec($curl));
function getUnixTimestamp () {
list($s1, $s2) = explode(' ', microtime());
return sprintf('%.0f',(floatval($s1) + floatval($s2)) * 1000);
}
using System;
using System.IO;
using System.Net;
using System.Net.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.Text;
public class ApiDemo {
private const String url = "https://api.shuxuntech.com/v1/express/query";
private const String method = "POST";
private const String appKey = "您的appKey";
private const String appSecret = "您的appSecret";
public static void Main(string[] args) {
TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
String timestamp = Convert.ToInt64(ts.TotalMilliseconds).ToString();
String sign = SHA256(appKey + timestamp + appSecret);
HttpWebRequest httpRequest = null;
HttpWebResponse httpResponse = null;
httpRequest = (HttpWebRequest) WebRequest.CreateDefault(new Uri(url));
httpRequest.Method = method;
httpRequest.ContentType = "application/x-www-form-urlencoded; charset=UTF-8";
httpRequest.Headers.Add("appKey", appKey);
httpRequest.Headers.Add("timestamp", timestamp);
httpRequest.Headers.Add("sign", sign);
String no = "";
String code = "";
String tel = "";
String params = "no=" + no + "&code=" + code + "&tel=" + tel;
byte[] data = Encoding.UTF8.GetBytes(params);
using (Stream stream = httpRequest.GetRequestStream()) {
stream.Write(data, 0, data.Length);
}
httpResponse = (HttpWebResponse) httpRequest.GetResponse();
Console.WriteLine(httpResponse.StatusCode);
Stream st = httpResponse.GetResponseStream();
StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
Console.WriteLine(reader.ReadToEnd());
}
public static string SHA256(string str) {
byte[] SHA256Data = Encoding.UTF8.GetBytes(str);
SHA256Managed Sha256 = new SHA256Managed();
byte[] by = Sha256.ComputeHash(SHA256Data);
return BitConverter.ToString(by).Replace("-", "").ToLower();
}
}
java
python
php
c#
产品详情
API文档
示例代码
产品价格










