# 查快递

**请求方式：** GET

**接口地址：** https://api.hk0.cc/api/kd

**接口描述：** 查快递物流

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| tracking_number | string | query | 必传 | — | — | 快递单号，通常是一串10-20位的数字或字母数字组合 |
| carrier_code | string | query | 可选 | — | — | 快递公司编码（可选）。不填写时系统会自动识别，填写后可加快查询速度 |
| phone | string | query | 必传 | — | — | 收件人手机尾号，4位数字（可选）。部分快递公司需要验证手机尾号才能查询详细物流信息 |

## 返回示例

```json
{
  // 快递单号
  "tracking_number": "YT1234567890123",
  // 快递公司编码
  "carrier_code": "yuantong",
  // 快递公司名称
  "carrier_name": "圆通速递",
  // 物流轨迹数量
  "track_count": 3,
  // 物流轨迹列表，按时间倒序排列
  "tracks": [
    {
      // 物流更新时间
      "time": "2025-10-27 15:30:00",
      // 物流状态描述
      "context": "快件已签收，感谢使用圆通速递"
    }
  ]
}
```