快递按次查询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 文档 / 调用示例」复制请求地址。核心请求参数：

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：快递公司简称。

六、计费说明

按次查询采用资源包模式，调用即扣次、查不到不扣。具体套餐、价格与免费额度以阿里云商品页为准。

七、常见问题（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