加载接口文档…
3.8万
累计调用
381ms
平均响应
99.98%
服务可用性
10 次/日
免费额度
访问限制
查看更多方案 →
文档链接
复制文档地址
https://apizero.cn/aidocs/express/raw.md接口请求地址
https://v1.apizero.cn/api/express
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/express?com=ems&number=YT7460266600081&phone=1234
接口信息备注
指定 EMS（com=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_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| 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": "YT7460266600081",
"com": "yto",
"com_name": "圆通快递",
"state": 0,
"status": "EMPTY",
"status_desc": "查询结果为空，未查到物流轨迹信息",
"trace_count": 0,
"traces": []
},
"request_id": "ms7z8i3g54f93f56",
"tips": "极数本源 · https://apizero.cn"
}免责声明
本接口数据由极数本源平台提供，仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准，平台不对因数据使用产生的任何后果承担直接责任。
请遵守《服务条款》《隐私政策》，不得将本接口用于违法、违规或侵犯他人权益的场景。
如发现数据异常或服务故障，请通过 contact@apizero.cn 反馈。