快递物流查询 API 接入文档express

匿名每日 30 次、QPS 2；登录用户每日 100 次、QPS 5（全部免费）。顺丰 / 中通必须传 phone 参数（手机号后 4 位），否则上游返回错误。

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

curl "https://v1.apizero.cn/api/express?number=YT7460266600081&com=yto&phone=1234&key=YOUR_API_KEY"

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/express",
    params={
    "number": "YT7460266600081",
    "com": "yto",
    "phone": "1234",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "number": "YT7460266600081",
  "com": "yto",
  "phone": "1234",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/express?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/express", nil)
	q := req.URL.Query()
	q.Set("number", "YT7460266600081")
	q.Set("com", "yto")
	q.Set("phone", "1234")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/express?" . http_build_query([
    "number" => "YT7460266600081",
    "com" => "yto",
    "phone" => "1234",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

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

{
    "code": 0,
    "msg": "成功",
    "data": {
        "number": "YT7460266600081",
        "com": "yto",
        "com_name": "圆通快递",
        "state": 3,
        "status": "DELIVERED",
        "status_desc": "已签收",
        "trace_count": 3,
        "traces": [
            {
                "time": "2026-05-06 14:23:11",
                "content": "【上海市】您的快件已签收，签收人：本人"
            },
            {
                "time": "2026-05-06 09:15:32",
                "content": "【上海市】快件正在派送途中（派件员：张三 138****1234）"
            },
            {
                "time": "2026-05-05 22:41:08",
                "content": "【广州市】快件离开 广州转运中心 发往 上海转运中心"
            }
        ]
    },
    "request_id": "abc123def456"
}

• 1.0.0(2026-05-06)
  • 首次上线，支持 100+ 主流快递公司物流查询
  • 内建 5 分钟缓存（节省上游 quota）
  • 自动识别快递公司，无需手动指定 com
  • 支持顺丰 / 中通的隐私保护参数 phone
  • 上游 422/400 业务错误透传消息（用户友好）