快递查询2

GET 快递查询

查询快递物流状态和跟踪详情，自动识别快递公司，支持圆通、中通、顺丰、韵达、申通、极兔等主流快递。

GET https://api.tinyaii.cn/v1/kuaidi/track

请求参数

参数名类型必填说明示例
tracking_nostring必填快递运单号YT1234567890123

返回字段

字段类型说明
tracking_nostring查询的快递运单号
packagesarray包裹信息列表（一个单号可能对应多个包裹）
packages[].cpstring快递公司编码（如：YTO=圆通、ZTO=中通、SF=顺丰、YD=韵达）
packages[].cpNamestring快递公司全称
packages[].statestring包裹状态：INIT=已揽收、ON_ROUTE=运输中、DELIVERING=派送中、SIGNED=已签收、FINISH=已完成
packages[].operateMessagestring最新一条操作描述
packages[].operateTimestring最新操作时间（格式：YYYYMMDDHHmmss）
packages[].trackingDetailsarray物流跟踪详情列表（按时间倒序）
packages[].trackingDetails[].timestring操作时间（格式：YYYYMMDDHHmmss）
packages[].trackingDetails[].contextstring操作描述（如：已到达XX转运中心、正在派送中）

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "tracking_no": "YT1234567890123",
    "packages": [
      {
        "cp": "YTO",
        "cpName": "圆通速递",
        "state": "SIGNED",
        "operateMessage": "您的快件已签收，签收人：本人签收",
        "operateTime": "20260603154333",
        "trackingDetails": [
          {
            "time": "20260603154333",
            "context": "您的快件已签收，签收人：本人签收"
          },
          {
            "time": "20260603092100",
            "context": "正在派送中，快递员：张师傅 13800138000"
          },
          {
            "time": "20260602221500",
            "context": "已到达 广东深圳转运中心"
          },
          {
            "time": "20260601180000",
            "context": "已离开 浙江义乌转运中心"
          },
          {
            "time": "20260601100000",
            "context": "已揽收，发往 广东深圳"
          }
        ]
      }
    ]
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/kuaidi/track?tracking_no=YT1234567890123" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/kuaidi/track?tracking_no=YT1234567890123", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/kuaidi/track",
    params={"tracking_no": "YT1234567890123"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。