加载接口文档…
2K
累计调用
2270ms
平均响应
100.00%
服务可用性
5 次/日
免费额度
访问限制
查看更多方案 →我的方案免费方案
QPS 2今日已用 … / 5 次/日…
登录并携带 API Key 可使用上方免费额度；会员额度见下方各档
接口请求地址
https://v1.apizero.cn/api/express-pro
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=ems&phone=1234
接口信息备注
指定 EMS（com=ems）。免费版没有 EMS，请用本接口。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| number | string | 必填 · 快递单号（8–40 位字母数字） · 示例：YT7460266600081 |
| com | string | 可选 · 快递公司编码，此处固定 ems · 默认 ems · 示例：ems |
| phone | string | 可选 · 手机号后 4 位（顺丰 / 中通等场景可能需要） · 示例：1234 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| number | string | 单号 |
| com | string | 公司编码 |
| com_name | string | 公司中文名 |
| status | string | 状态码（如 EMPTY / TRANSIT / SIGNED） |
| status_desc | string | 状态说明 |
| traces | array | 轨迹：time / content |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"number": "EA000123456CN:0000",
"com": "ems",
"com_name": "EMS",
"state": 3,
"status": "SIGNED",
"status_desc": "已签收",
"trace_count": 14,
"traces": [
{
"time": "2026-03-06 11:31:58",
"content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
},
{
"time": "2026-03-03 17:29:26",
"content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
}
]
},
"tips": "极数本源 · https://apizero.cn",
"request_id": "req_demo_ems_0001"
}免责声明
本接口数据由极数本源平台提供，仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准。