快递物流查询API接口
https://v2.xxapi.cn/api/express接口描述
免费API提供实时快递物流信息查询功能,支持多家主流快递公司,返回运单状态、物流轨迹、更新时间和签收信息,适用于电商系统、物流管理和订单跟踪等应用场景。
请求参数
怎么传递这个 Key?
推荐
方法 1:Bearer Token (Header)
标准规范,兼容性最好,最安全
Authorization:Bearer Key
方法 2:放在请求头 (Header)
直接使用 Authorization,无需前缀
Authorization:Key
方法 3:放在请求头 (Header)
自定义 Header key 字段
key:Key
不推荐
方法 4:放在网址后面 (Query)
不安全,可能泄露 Key,即将弃用
网址?key=Key
相关套餐
请求示例
var axios = require('axios')
var config = {
method: 'get',
url: ''
}
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data))
})
.catch(function (error) {
console.log(error)
})axios
ajax
fetch
xhr
php
python
返回示例
{
"code": 200,
"msg": "数据请求成功",
"data": {
"cpCode": "ZTO",
"cpMobile": "95311",
"cpUrl": "https://www.zto.com/",
"logisticsCompanyName": "中通快递",
"logisticsStatus": "SIGN",
"logisticsStatusDesc": "已签收",
"logisticsTraceDetailList": [
{
"areaCode": "CN440100000000",
"areaName": "广东省,广州市",
"desc": "【广州市】 快件已由广州新永福黄慕华(18202026334)揽收(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "ACCEPT",
"subLogisticsStatus": "ACCEPT",
"time": 1764899322000
},
{
"areaCode": "CN440100000000",
"areaName": "广东省,广州市",
"desc": "【广州市】 快件已发往 广州转运中心(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1764956976000
},
{
"areaCode": "CN440100000000",
"areaName": "广东省,广州市",
"desc": "【广州市】 广州新永福 已一次安检,安检通过",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1764958086000
},
{
"areaCode": "CN440100000000",
"areaName": "广东省,广州市",
"desc": "【广州市】 快件已到达 广州转运中心,场地已覆盖光伏供电,打造低碳智慧物流,共赴零碳未来!(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1764964515000
},
{
"areaCode": "CN440100000000",
"areaName": "广东省,广州市",
"desc": "【广州市】 广州转运中心 已二次安检,安检通过",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1764964708000
},
{
"areaCode": "CN440100000000",
"areaName": "广东省,广州市",
"desc": "【广州市】 快件已发往 青岛转运中心(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1764964711000
},
{
"areaCode": "CN370200000000",
"areaName": "山东省,青岛市",
"desc": "【青岛市】 快件已到达 青岛转运中心,场地已覆盖光伏供电,打造低碳智慧物流,共赴零碳未来!(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1765065478000
},
{
"areaCode": "CN370200000000",
"areaName": "山东省,青岛市",
"desc": "【青岛市】 快件已发往 烟台蓬莱(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1765065905000
},
{
"areaCode": "CN370684000000",
"areaName": "山东省,烟台市,蓬莱市",
"desc": "【烟台市】 快件已到达 烟台蓬莱(如遇问题无需找商家/平台,请致电【客服热线:】更快解决,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "TRANSPORT",
"subLogisticsStatus": "TRANSPORT",
"time": 1765087901000
},
{
"areaCode": "CN370684000000",
"areaName": "山东省,烟台市,蓬莱市",
"desc": "烟台蓬莱 快递员【赵永兴,】正在为您派件(大促期间快件较多,我们将尽快送达,请留意接听中通快递员外呼专属号码,如遇问题请联系快递员为您解决,无需找商家/平台。网点电话:,投诉电话:,或关注“中通快递”官方微信公众号获取实时物流信息)",
"logisticsStatus": "DELIVERING",
"subLogisticsStatus": "DELIVERING",
"time": 1765094254000
},
{
"areaCode": "CN370684000000",
"areaName": "山东省,烟台市,蓬莱市",
"desc": "快件已由快递员【赵永兴:】送达代收点存放,取件地址【兔喜生活-烟台蓬莱烟科东山中通店:烟科东山中通快递,营业时间09:00-21:00】,请及时取件。如遇取件码问题或找不到包裹等问题请联系快递员,无需找商家/平台。网点电话:,投诉电话:。关注“中通快递”官方微信公众号获取实时物流信息",
"logisticsStatus": "DELIVERING",
"subLogisticsStatus": "STA_INBOUND",
"time": 1765094284000
},
{
"areaCode": "CN370684000000",
"areaName": "山东省,烟台市,蓬莱市",
"desc": "您的快件已在代收点取出签收,如遇问题请联系快递员【赵永兴:】,无需找商家/平台。签收代收点:兔喜生活-烟台蓬莱烟科东山中通店,网点电话:,投诉电话:。关注“中通快递”官方微信公众号反馈问题,处理更快捷!感谢使用中通快递,期待再次为您服务!",
"logisticsStatus": "SIGN",
"subLogisticsStatus": "STA_SIGN",
"time": 1765252451000
}
],
"mailNo": "78963420079490",
"takeTime": "2天6小时9分",
"theLastMessage": "您的快件已在代收点取出签收,如遇问题请联系快递员【赵永兴:】,无需找商家/平台。签收代收点:兔喜生活-烟台蓬莱烟科东山中通店,网点电话:,投诉电话:。关注“中通快递”官方微信公众号反馈问题,处理更快捷!感谢使用中通快递,期待再次为您服务!",
"theLastTime": "2025-12-09 11:54:11"
},
"request_id": "1cd11cd0b34be6b82a10b312"
}
快递公司对照表(type – 快递公司)
| type | 快递公司 |
|---|---|
| YTO | 圆通快递 |
| YUNDA | 韵达快递 |
| ZTO | 中通快递 |
| ZTOKY | 中通快递 |
| STO | 申通快递 |
| HTKY | 百世快递 |
| BESTJT | 百世快递 |
| JT | 极兔快递 |
| SF | 顺丰速运 |
| FW | 丰网速运 |
| EMS | 中国邮政(含:邮政国内小包、EMS、E邮宝、EMS经济快递、EMS特快专递、邮政快递包裹等) |
| JD | 京东快递 |
| KYE | 跨越速运 |
| DBKD | 德邦快递 |
| XFWL | 信丰快递 |
| UC | 优速快递 |
| TTKDEX | 天天快递 |
| ZJS | 宅急送 |
| ANE56 | 安能 |
| FAST | 快捷 |
| DBL | 德邦物流 |
| DBKY | 德邦快运 |
| ZTKY | 中铁物流 / 飞豹快递 |
| CRE | 中铁快运 |
| SURE | 速尔快递 |
| UAPEX | 全一快递 |
| CNEX | 佳吉快运 |
| CP449455 | 京广速运 |
| JYM | 加运美速递 |
| YDKY | 韵达快运 |
| FEDEX | 联邦快递 |
| RRS | 日日顺 |
| SNWL | 苏宁快递 |
| ZMKM | 丹鸟 |
| RFD | 如风达 |
| YCKY | 远成快运 |
| HOKY | 华企快运 |
| YFEXPRESS | 越丰物流 |
| AIR | 亚风速递 |
| MANCOWL | 万家物流 |
| SZML56 | 明亮物流 |
| CXCOD | 传喜物流 |
| D4PX | 递四方 |
| TNT | TNT |
| UPS | UPS |
| USPS | USPS |
| DHLCN | DHL中国 |
| EMSGJ | EMS国际 |
| CNPOSTGJ | 邮政国际包裹 |
| DHLDE | DHL德国 |
| KERRYEAS | 嘉里大通 |
| DHL | DHL全球 |
| FEDEXUS | FedEx美国 |
| FEDEXCN | FedEx中国 |
| ARAMEX | Aramex |
| SANTAI | 三态速递 |
| OCS | OCS |
| MYAAE | AAE全球专递 |
| YYWL | 燕文物流 |
| ASENDIA | Asendia USA |
| RUSTON | 俄速通 |
| XLOBO | 贝海国际速递 |
| SPSR | 中俄快递 |
| SAD | 赛澳递 |
| SUIJIAWL | 穗佳物流 |
| ROYALMAIL | 英国皇家邮政 |
| JKYZ | 捷克邮政 |
| POSTSE | 瑞典邮政 |
| BLYZ | 波兰邮政 |
| FGYZ | 法国邮政 |
| POSTTR | 土耳其邮政 |
| POSTCL | 智利邮政 |
物流状态对照表
| 序号 | 物流主状态 | 状态描述 | 物流子状态 | 子状态描述 |
|---|---|---|---|---|
| 1 | WAIT_ACCEPT | 待揽收 | RECEIVE | 接单中 |
| WAIT_ACCEPT | 待揽收 | |||
| 2 | ACCEPT | 已揽收 | ACCEPT | 已揽收 |
| 3 | TRANSPORT | 运输中 | TRANSPORT | 运输中 |
| SEND_ON | 转单或修改地址转寄 | |||
| ARRIVE_CITY | 到达目的城市 | |||
| 4 | DELIVERING | 派件中 | DELIVERING | 派件中 |
| STA_INBOUND | 已放入快递柜或驿站 | |||
| 5 | AGENT_SIGN | 已代签收 | AGENT_SIGN | 已代签收 |
| 6 | SIGN | 已签收 | SIGN | 已签收 |
| STA_SIGN | 从快递柜或驿站取出 | |||
| RETURN_SIGN | 退回签收 | |||
| FAILED | 包裹异常 | |||
| REFUSE_SIGN | 拒收 | |||
| 7 | FAILED | 包裹异常 | DELIVER_ABNORMAL | 派件异常 |
| RETENTION | 滞留件 | |||
| ISSUE | 问题件 | |||
| RETURN | 退回件 | |||
| DAMAGE | 破损 | |||
| CANCEL_ORDER | 揽件取消 |