接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 运单号 | number | 是 | 快递物流单号，例：number=12515413485486654 |
| 手机号 | mobile | 否 | 手机号或手机号后四位 顺丰速运/跨越速运需要传入，例：mobile=13212345678 |
| 快递公司编号 | code | 否 | 快递公司编号 例如圆通:YTO 传入快递公司编号响应更快，例：code=YTO |
| 明细排序 | sort | 否 | 物流明细排序，desc：倒序，asc：升序，默认asc，例：sort=asc |
| 返利账号 | fid | 是 | 接收返利金的数字账号ID，返利金可在后台菜单【活动中心】-【返利金】自助提现。例：fid=10000000 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 提示信息 | msg | 提示信息 |
| 快递公司编号 | wlcode | 快递公司编号 |
| 快递公司名称 | name | 快递公司名称 |
| 快递公司LOGO | logo | 快递公司LOGO |
| 运单号 | number | 运单号 |
| 物流状态 | status | 物流状态 |
| 物流状态描述 | statusmsg | 物流状态描述 |
| 物流最后状态描述 | lastmsg | 物流最后状态描述 |
| 物流最后状态时间 | lasttime | 物流最后状态时间 |
| 整个运输时间 | alltime | 整个运输时间 |
| 快递员 | courier | 快递员 |
| 快递员联系方式 | courierphone | 快递员联系方式 |
| 物流明细数据集 | data | 物流明细数据集 |
| 物流节点 | data.areaName | 物流节点 |
| 物流子状态 | data.subLogisticsStatus | 物流子状态 |
| 物流状态 | data.logisticsStatus | 物流状态 |
| 物流变更时间 | data.time | 物流变更时间 |
| 物流节点描述 | data.desc | 物流节点描述 |
| 行政编码 | data.Code | 物流节点行政编码 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"msg": "ok",
"wlcode": "EMS",
"name": "邮政快递包裹",
"logo": "https://img2.jumdata.com/express-logo/youzhengguonei.png",
"number": "98069508*****",
"status": "SIGN",
"statusmsg": "已签收",
"lastmsg": "您的快件已取走【***超市店】，如有疑问请电联快递员【电话:********】，揽投部【电话:0816-2365417】，投诉电话【电话:0816-2365417】。有事呼叫我，少一次投诉，多一份感恩。中国邮政将全心呵护您的所托，监督电话11183。",
"lasttime": "2025-05-08 19:39:42",
"alltime": "3天6小时22分",
"courier": null,
"courierphone": "15181625270",
"data": [{
"areaName": "南通市",
"subLogisticsStatus": "ACCEPT",
"time": 1746422261000,
"logisticsStatus": "ACCEPT",
"desc": "中国邮政 已收取快件"
}, {
"areaName": "南通市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746432846000,
"logisticsStatus": "TRANSPORT",
"desc": "快件已在【南通市电商客户叠石桥三星揽收部】完成分拣，准备发出"
}, {
"areaName": "南通市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746432847000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开【南通市电商客户叠石桥三星揽收部】，正在发往【南通市邮区中心叠石桥快件处理中心】"
}, {
"areaName": "南通市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746432949000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达【南通市邮区中心叠石桥快件处理中心】"
}, {
"areaName": "南通市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746462687000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开【南通市邮区中心叠石桥快件处理中心】，正在发往下一站"
}, {
"areaName": "内江市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746584914000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达【内江市邮区中心】"
}, {
"areaName": "内江市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746601366000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开【内江市邮区中心】，正在发往下一站"
}, {
"areaName": "绵阳市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746634350000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达【绵阳市快件处理车间】"
}, {
"areaName": "绵阳市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746635596000,
"logisticsStatus": "TRANSPORT",
"desc": "快件离开【绵阳市快件处理车间】，正在发往下一站"
}, {
"areaName": "绵阳市",
"subLogisticsStatus": "TRANSPORT",
"time": 1746672897000,
"logisticsStatus": "TRANSPORT",
"desc": "快件到达【绵阳市邮政大厦直投中心】"
}, {
"areaName": "绵阳市",
"subLogisticsStatus": "DELIVERING",
"time": 1746672898000,
"logisticsStatus": "DELIVERING",
"desc": "您的快件已安排派送，节日期间快件较多，我们将尽快送达，感谢您的理解和耐心等待。请保持电话畅通，如急需投递请电联快递员【杜磊，电话:15181******】，揽投部【电话:0816-2365417】，更快更方便，少一次投诉，多一份感恩。监督电话11183。"
}, {
"areaName": "绵阳市",
"subLogisticsStatus": "STA_INBOUND",
"time": 1746676582000,
"logisticsStatus": "DELIVERING",
"desc": "您的快件已派送至【***超市店】，自提点电话:17709045774，请您凭取件码领取快件，如有疑问请电联快递员【电话:15181******】，揽投部【电话:0816-2365417】，投诉电话【电话:0816-2365417】。有事呼叫我，少一次投诉，多一份感恩。中国邮政将全心呵护您的所托，监督电话11183。"
}, {
"areaName": "绵阳市",
"subLogisticsStatus": "SIGN",
"time": 1746704382000,
"logisticsStatus": "SIGN",
"desc": "您的快件已取走【***超市店】，如有疑问请电联快递员【电话:15181******】，揽投部【电话:0816-2365417】，投诉电话【电话:0816-2365417】。有事呼叫我，少一次投诉，多一份感恩。中国邮政将全心呵护您的所托，监督电话11183。"
}]
}
更新记录
