加载接口文档…
查询申通、圆通、顺丰、中通、百世、极兔的物流轨迹。调用时请指定公司编码 com。顺丰、中通须传手机号后 4 位。 韵达、京东、EMS,以及不指定公司、由系统自动识别单号,请用快递查询 PRO。两套接口返回字段相同。
由 极数本源 提供·更新于 今天
7.2万
累计调用
489ms
平均响应
100.00%
服务可用性
10 次/日
免费额度
免费版指定百世(com=best)。
| 名称 | 类型 | 说明 |
|---|---|---|
| number | string | 必填 · 快递单号(8–40 位字母数字) · 示例:YT7460266600081 |
| com | string | 可选 · 快递公司编码,此处固定 best · 默认 best · 示例:best |
| 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": "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"
}本接口数据由极数本源平台提供,仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准,平台不对因数据使用产生的任何后果承担直接责任。
请遵守《服务条款》《隐私政策》,不得将本接口用于违法、违规或侵犯他人权益的场景。
如发现数据异常或服务故障,请通过 contact@apizero.cn 反馈。