查询快递公司简称

接口说明

本接口用于配合快递查询V2接口使用，可获取各快递公司的简称短码。支持获取公司列表和按关键词搜索两种模式，无需密钥即可免费调用。

调用地址

https://api.xunjinlu.fun/api/kuidi/v2/list

请求方式

GET、POST

鉴权说明

本接口无需密钥，可直接调用。

请求参数

补充说明：

• 当 action=search 时，必须传入 keyword。
• 当 action=list 时，可通过 country 按国家进行筛选。
• 返回列表中的 code 字段即为快递公司对应的简称短码。

成功响应示例

{
  "code": 12001,
  "status": "success",
  "message": "ok",
  "data": {
    "total": 1769,
    "carriers": [
      {
        "code": "ZTO",
        "name": "中国中通快递",
        "country": "中国",
        "requires_phone": "已知需要"
      },
      {
        "code": "YTO",
        "name": "中国圆通速递",
        "country": "中国",
        "requires_phone": "未知"
      }
    ]
  }
}

响应字段说明

错误响应示例

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

业务错误码说明

调用示例

终端 curl（bash）

获取全部快递公司列表：

curl -X GET "https://api.xunjinlu.fun/api/kuidi/v2/list?action=list"

按国家筛选快递公司：

curl -X GET "https://api.xunjinlu.fun/api/kuidi/v2/list?action=list&country=中国"

搜索快递公司简称：

curl -X GET "https://api.xunjinlu.fun/api/kuidi/v2/list?action=search&keyword=中通"

PHP

使用 cURL 获取快递公司列表：

// 查询快递公司简称
$url = "https://api.xunjinlu.fun/api/kuidi/v2/list?action=list";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

搜索快递公司：

// 使用关键词搜索快递公司
$url = "https://api.xunjinlu.fun/api/kuidi/v2/list?action=search&keyword=圆通";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['status'] . PHP_EOL;
var_dump($data['data']['carriers'][0] ?? null);

注意事项

• 本接口无需密钥，可直接调用，但请勿将调用地址嵌入前端页面或公开分享，避免被滥用消耗免费额度。
• 建议统一通过 HTTPS 调用，确保参数与返回内容在传输过程中不被篡改。
• 请求频率请保持在合理范围内，避免短时间大量请求触发服务端限流。
• action=search 时 keyword 必填，否则接口会返回错误；keyword 支持公司简称或名称的模糊匹配。
• country 参数仅在 action=list 时生效，action=search 时传入 country 不会产生筛选效果。
• 列表中可能包含大量数据（示例返回 1769 条），如非必要请优先使用 action=search 精确查询，以减少响应体大小和传输时间。
• 请直接使用返回 data.carriers[].code 作为后续快递查询 V2 接口的快递公司编码，不要根据名称自行猜测或硬编码映射。
• requires_phone 字段仅作提示，实际是否强制填写手机号应以快递查询 V2 接口的请求规则为准。