支持一千多家快递公司,覆盖顺丰、申通、圆通、宅急送、韵达、中通、百世、天天、四通一达、京东、EMS等快递物流公司,与官网同步数据更新。另提供快递订阅推送接口,按单号计费,即同一单号计费一次。 —— 我们只做精品!
返回首页
快递查询
请求示例
curl -X POST https://api.zhuimengapi.com/api/v1/express_query \
-H "X-API-Key: RPA-xxxxxxxx"
-d "expressCode=your_expressCode \
-d "number=your_number \
-d "mobile=your_mobile \
-d "sort=your_sort"import requests
url = "https://api.zhuimengapi.com/api/v1/express_query"
headers = {"X-API-Key": "RPA-xxxxxxxx"}
data = {
"expressCode": "your_expressCode",
"number": "your_number",
"mobile": "your_mobile",
"sort": "your_sort"
}
res = requests.post(url, data=data, headers=headers)
print(res.json())const axios = require('axios');
axios.post("https://api.zhuimengapi.com/api/v1/express_query", {
expressCode: "your_expressCode",
number: "your_number",
mobile: "your_mobile",
sort: "your_sort"
}, {
headers: { "X-API-Key": "RPA-xxxxxxxx" }
}).then(res => console.log(res.data));响应示例
{
"code": 0,
"msg": "code 对应的描述",
"charge": false,
"taskNo": "本次请求号",
"data": {
"expressCode": "快递公司编号",
"expressCompanyName": "快递公司名称",
"expressCompanyLogo": "快递公司 logo",
"number": "运单编号",
"logisticsStatus": "物流状态,详见:物流状态编码对照表",
"logisticsStatusDesc": "物流状态描述",
"theLastMessage": "运单号物流流转当前最新描述",
"theLastTime": "运单号物流流转当前最新变更时间",
"takeTime": "从揽收到送达所耗时间",
"courier": "快递员",
"courierPhone": "快递员联系方式",
"logisticsTraceDetails": []
},
"data.logisticsTraceDetails[].time": 0,
"data.logisticsTraceDetails[].logisticsStatus": "物流状态,详见:物流状态编码对照表",
"data.logisticsTraceDetails[].subLogisticsStatus": "物流子状态,详见:物流状态编码对照表",
"data.logisticsTraceDetails[].desc": "物流路由信息描述内容",
"data.logisticsTraceDetails[].areaCode": "路由节点所在地区行政编码",
"data.logisticsTraceDetails[].areaName": "路由节点所在地区"
}
接口信息
请求地址
https://api.zhuimengapi.com/api/v1/express_query
请求方式
POST
Content-Type
application/x-www-form-urlencoded
鉴权方式
X-API-Key: RPA-xxxxxxxx
请求参数
expressCode
string
快递公司编号,例如圆通:YTO,详见:快递公司编码对照表
number
string
必填 运单编号
mobile
string
手机号,顺丰速运、中通、跨越速运需要传入收/寄件人手机号或后四位手机号
sort
string
物流明细排序,desc:倒序,asc:升序,默认asc
返回字段
code
int
状态码,200 表示成功,详见 code 返回码说明
msg
string
code 对应的描述
charge
bool
计费标志
taskNo
string
本次请求号
data
object
返回数据
expressCode
string
快递公司编号
expressCompanyName
string
快递公司名称
expressCompanyLogo
string
快递公司 logo
number
string
运单编号
logisticsStatus
string
物流状态,详见:物流状态编码对照表
logisticsStatusDesc
string
物流状态描述
theLastMessage
string
运单号物流流转当前最新描述
theLastTime
string
运单号物流流转当前最新变更时间
takeTime
string
从揽收到送达所耗时间
courier
string
快递员
courierPhone
string
快递员联系方式
logisticsTraceDetails
array
物流明细
data.logisticsTraceDetails[].time
int
物流变更时间(毫秒时间戳)
data.logisticsTraceDetails[].logisticsStatus
string
物流状态,详见:物流状态编码对照表
data.logisticsTraceDetails[].subLogisticsStatus
string
物流子状态,详见:物流状态编码对照表
data.logisticsTraceDetails[].desc
string
物流路由信息描述内容
data.logisticsTraceDetails[].areaCode
string
路由节点所在地区行政编码
data.logisticsTraceDetails[].areaName
string
路由节点所在地区
响应状态说明
不同接口的成功返回字段可能不同,请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构,失败调用不计费。
- 200 请求成功返回字段以本接口的响应示例和实际结果为准,部分接口不包含 code 字段。 按接口规则计费
- 400 参数或业务错误请求参数无效时返回安全、明确的修正提示。 不扣费
- 401 API Key 无效密钥缺失、格式错误、无效或已经过期。 不扣费
- 402 账户余额不足请充值后重试;本次请求不会进入接口处理。 不扣费
- 403 访问被拒绝IP 规则限制,或当前账户无权调用仅限 VIP 的接口。 不扣费
- 404 接口路由不存在请检查请求地址中的 API 路由是否正确。 不扣费
- 405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法,并查看 Allow 响应头。 不扣费
- 413 请求体过大单次请求最大允许 20MB。 不扣费
- 429 请求频率超限请根据 Retry-After 响应头稍后重试。 不扣费
- 500 系统服务异常请稍后重试;持续出现时请向技术支持提供 request_id。 不扣费
- 502 接口服务暂时不可用接口处理异常或暂时不可用,请稍后重试。 不扣费
- 503 系统服务暂时不可用服务正在恢复,请稍后重试。 不扣费
错误响应示例
使用 request_id 查询对应调用日志
{
"code": 400,
"message": "请输入有效的身份证号码",
"data": null,
"request_id": "1-xxxxxxxx",
"time": "2026-07-29 12:00:00"
}
请求地址
https://api.zhuimengapi.com/api/v1/express_query
请求方式
POST
Content-Type
application/x-www-form-urlencoded
鉴权 Header
X-API-Key
Params
GET 请求只通过 URL 查询参数发送
Body 表单模式
POST + application/x-www-form-urlencoded 使用表单键值对请求体
快速信息
| 接口路由 | express_query |
| 接口分类 | 企业服务 |
| 请求方式 | POST |
| 原价 | 0.15 积分/次(约 ¥0.0075/次) |
| 频率限制 | 不限制 |
| 认证方式 | X-API-Key |
| 接口提供 | 官方接口 |