快递按次查询API怎么用？万维易源全球快递物流查询
万维易源「全球快递物流查询·按次查询」是阿里云云市场的一款快递物流查询 API，支持国内外 1500+ 家快递公司、单号自动识别、与官网同步更新；每次成功调用计 1 次费，查不到不计费。本文讲清它的核心能力、接入步骤、返回参数与计费方式，并附 Python 调用示例。
一、什么是快递按次查询 API？
万维易源（开票主体：昆明秀派科技有限公司）在阿里云云市场推出的快递物流查询接口，属于"车辆交通与物流"类目，10 年老店。它对外提供标准化 HTTP API：你传入快递单号，它返回该单号的实时物流轨迹。
"按次查询"指每次成功调用计 1 次费；若查不到物流信息（flag=false），则不扣费。与之对应的是"按单查询"（一个单号 30 天内任意查只扣 1 次费），两款商品按业务特征选择。
二、核心能力
- 单号自动识别：传入
com=auto，接口自动判断快递公司，不用记各家编码。 - 国内外 1500+ 家快递：覆盖顺丰、韵达、中通、申通、圆通、邮政、DHL、UPS、宅急送、德邦、百世、安捷、速通、天天、京东、EMS 等。
- 实时物流轨迹：返回完整时间线（time + context）。
- 状态机 status 1-10：从"在途中"到"已签收"全程可映射。
- 与官网同步更新：快递官网可查，这里就能查。
- 特殊要求：中通 / 顺丰 / 跨越查询需上传手机号后 4 位（
phone）。
三、适用场景
- 电商订单详情页的"物流跟踪"组件
- 客服系统自动回答"我的快递到哪了"
- 物流异常监控与预警
- 跨境包裹全球追踪
四、怎么接入（教程）
在阿里云云市场购买后，控制台获取 APPCODE，再从商品详情页的「API 文档 / 调用示例」复制请求地址。核心请求参数：
| 参数 | 必填 | 说明 |
|---|---|---|
| com | 否 | 快递公司编码，auto 表示自动识别 |
| nu | 是 | 快递单号 |
| phone | 条件 | 手机尾号后 4 位（顺丰 / 中通 / 跨越必填） |
Python 示例（鉴权与网关地址以阿里云控制台为准）：
import requests
APPCODE = "你的阿里云APPCODE" # 云市场购买后在控制台获取
GATEWAY = "商品详情页API文档中的请求地址" # 复制自商品页「API文档」
resp = requests.get(
f"https://{APPCODE}@{GATEWAY}",
params={
"com": "auto", "nu": "KY4000645091211", "phone": "2611"},
)
body = resp.json()["showapi_res_body"] # 具体字段名以官方文档为准
print(body.get("expTextName"), "status=", body.get("status"), "flag=", body.get("flag"))
for node in body.get("data", []):
print(node.get("time"), node.get("context"))
五、返回参数怎么读
flag：true 表示查询成功，前端据此判断是否展示轨迹。status：快递状态（见下表），用来驱动你的进度条。data：轨迹时间线，每条含time与context，直接渲染成物流时间轴。fee_num：本次计费次数，0 表示未计费。expTextName：快递公司简称。
| status | 含义 | status | 含义 |
|---|---|---|---|
| 1 | 暂无记录 | 6 | 问题 / 疑难件 |
| 2 | 在途中 | 7 | 无效单 |
| 3 | 派送中 | 8 | 超时单 |
| 4 | 已签收 | 9 | 签收失败 |
| 5 | 用户拒签 | 10 | 退回 |
六、计费说明
按次查询采用资源包模式，调用即扣次、查不到不扣。具体套餐、价格与免费额度以阿里云商品页为准。
七、常见问题（FAQ）
Q：支持哪些快递公司？
A：国内外 1500+ 家，含顺丰、四通一达、京东、EMS、DHL、UPS、宅急送、德邦、百世等。
Q：为什么顺丰查不到？
A：顺丰、中通、跨越必须传 phone（手机尾号后 4 位）；隐私号传完整后 4 位，例如 13xxxxx1-234 传 1234。
Q：单号识别不了怎么办？
A：用 com=auto 自动识别；若失败，可从快递公司列表查编码后显式传入。
Q：数据多久更新一次？
A：与对应快递官网同步，官网录入即可查。
Q：在阿里云怎么调用？
A：云市场购买后，控制台获取 APPCODE，按商品页 API 文档发起 HTTP 请求即可。
立即体验
? 查看商品与购买：【万维易源-全球快递物流查询单号自动识别服务（按次查询）】https://market.aliyun.com/detail/cmapi033187#sku=yuncode27187000015
