快递物流查询API接口

GET
https://v2.xxapi.cn/api/express

接口描述

免费API提供实时快递物流信息查询功能,支持多家主流快递公司,返回运单状态、物流轨迹、更新时间和签收信息,适用于电商系统、物流管理和订单跟踪等应用场景。

请求参数

怎么传递这个 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)
  })

返回示例

 

{
    "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 揽件取消