API文档 - FEER API

由 AI 生成：本文档由 AI 根据配置自动生成，仅供参考，实际接口以服务端返回为准。

---

接口简介

快递查询V1接口通过快递单号自动识别物流公司并返回中文物流信息，适用于电商、物流系统等需要实时跟踪包裹的场景。调用时需提供快递单号，若开启密钥访问则需同时传递key参数。当前支持中通、圆通、邮政等主流快递（不含顺丰/京东/菜鸟）。

---

请求说明

请求地址：https://api.xunjinlu.fun/api/kuaidi/v1.php
HTTP 方法：GET
常用请求头：

- Accept: application/json（建议显式声明） - 若需密钥：key 参数需通过 Query 传递

---

请求参数表

参数名	类型	必填	说明
<code>key</code>	string	是	接口访问密钥（开启密钥时必填）
<code>trackingNo</code>	string	是	快递运单号（6-30位字母数字，如<code>YT1234567890123</code>）

---

返回字段表

字段路径	类型	说明
<code>code</code>	int	状态码（200表示成功）
<code>message</code>	string	响应描述
<code>data.trackingNo</code>	string	运单号
<code>data.totalCount</code>	int	包裹数量
<code>data.packageInfoList</code>	array	包裹信息列表（对象数组）
<code>data.stateStatList</code>	array	状态统计列表（对象数组）
<code>api_info</code>	object	API 提供方信息

`packageInfoList` 对象字段

字段名	类型	说明
<code>cp</code>	string	快递公司代码（如<code>YTO</code>）
<code>cpName</code>	string	快递公司名称（如<code>圆通速递</code>）
<code>state</code>	string	包裹状态（如<code>AGENT</code>）
<code>signFlag</code>	string	签收标识（如<code>AUTOMATIC</code>）
<code>operateMessage</code>	string	最新物流描述
<code>operateTime</code>	string	最新物流时间
<code>trackingDetails</code>	array	详细物流轨迹（对象数组）

`trackingDetails` 对象字段

字段名	类型	说明
<code>time</code>	string	物流时间
<code>context</code>	string	物流描述
<code>state</code>	string	状态标识

---

返回 JSON 示例

成功响应

{
  "code": 200,
  "message": "查询成功",
  "data": {
    "trackingNo": "YT1234567890123",
    "totalCount": 1,
    "packageInfoList": [
      {
        "cpName": "圆通速递",
        "state": "AGENT",
        "operateMessage": "您的快件已到达[兔喜生活]...",
        "operateTime": "2026-03-24 06:17:31",
        "trackingDetails": [
          {
            "time": "2026-03-24 06:17:31",
            "context": "您的快件已到达[兔喜生活]...",
            "state": "AGENT"
          }
        ]
      }
    ]
  }
}

失败响应

{
  "code": 400,
  "message": "快递单号格式错误",
  "data": null
}

---

错误与状态

常见 HTTP 状态码：

- 200：查询成功 - 400：参数错误（如单号格式错误） - 401：密钥无效（开启密钥时） - 404：快递公司不支持

业务错误码：以返回的 message 字段描述为准（如 "快递单号不存在"）

---

调用示例

直接访问

https://api.xunjinlu.fun/api/kuaidi/v1.php?trackingNo=YT1234567890123

在浏览器中打开此 URL 可直接查看 JSON 响应

cURL

curl -G "https://api.xunjinlu.fun/api/kuaidi/v1.php" \
  -d "trackingNo=YT1234567890123" \
  -H "Accept: application/json"

Python requests

import requests

url = "https://api.xunjinlu.fun/api/kuaidi/v1.php"

params = {"trackingNo": "YT1234567890123"}

headers = {"Accept": "application/json"}

response = requests.get(url, params=params, headers=headers)

data = response.json()

print(data["message"])  # 输出：查询成功

PHP

<?php
$ch = curl_init();
$params = [
    'trackingNo' => 'YT1234567890123'
];
$url = "https://api.xunjinlu.fun/api/kuaidi/v1.php?" . http_build_query($params);

curl_setopt($ch, CURLOPT_URL, $url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_setopt($ch, CURLOPT_HTTPHEADER, ['Accept: application/json']);

$response = curl_exec($ch);

$data = json_decode($response, true);

echo $data['message'];  // 输出：查询成功

curl_close($ch);

?>

快递查询V1