一个入口,追踪全球包裹
粘贴运单号,系统自动识别承运商,把不同公司五花八门的物流事件统一成一眼能看懂的七种状态。批量查询、开发者 API 一并提供。
- 已下单
- 运输中
- 派送中
- 已签收
- 包裹已装上派送车辆,今日派送
- 到达目的地包裹中心
- 包裹已由发件仓揽收并处理
先把我们真正接通的做好
标「实时」的承运商由 XTrack 直接返回轨迹;其余承运商我们能识别单号,并给出官网查询直达链接——接入进度持续更新。
查询这件小事,做得细一点
自动识别承运商
按单号格式判断是哪家承运商;格式有重叠时按可信度依次尝试,不用你在下拉里找。
批量查询
从表格里整列复制过来直接粘贴,换行、逗号、空格都认;结果按在途、已签收、需关注分组。
统一的七种状态
各家承运商上百种事件代码,归一成已下单、运输中、派送中、已签收、投递异常、已退回、暂无记录。
开发者 API
REST 接口加 API Key,几行代码接进你的 ERP、店铺后台或客服系统;网页上看到的,接口里都能拿到。
按单号计费,不按次数
同一个单号在一个月内查多少次都只算一个额度。盯着一个包裹反复刷新,不会把套餐刷光。
不编造,不留痕
查不到就明说,并给出官网链接;访客的 IP 只以哈希形式用于限流,不保存明文。
三步,从单号到轨迹
粘贴运单号
一个或一批都行。访客每次最多 5 个,注册后每次 40 个。
自动识别并查询
系统判断承运商、向数据源取回轨迹,并缓存结果让下次更快。
查看或接入系统
在网页上看时间线、复制查询链接发给客户,或用 API 把状态写回你的订单。
一个请求,拿回标准化的轨迹
免费版就带 API 访问,先接起来跑通,再按单量选套餐。
- 单次最多 200 个单号的批量接口
- 响应头直接告诉你限流余量与本月已用额度
- 统一的错误码,失败原因一看就懂
curl https://xtrack.mcwoms.com/api/v1/trackings \ -H "X-API-Key: xt_live_••••••••" \ -H "Content-Type: application/json" \ -d '{"trackings":[{"tracking_number":"00340434161094000019"}]}' # → 200 OK { "trackings": [{ "tracking_number": "00340434161094000019", "carrier": { "code": "dhl", "name": "DHL Paket" }, "status": "out_for_delivery", "events": [ /* newest first */ ] }], "quota": { "used": 128, "limit": 2000 } }
const res = await fetch('https://xtrack.mcwoms.com/api/v1/trackings', { method: 'POST', headers: { 'X-API-Key': process.env.XTRACK_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify({ trackings: [{ tracking_number: '00340434161094000019' }], }), }); const { trackings, quota } = await res.json(); console.log(trackings[0].status); // "out_for_delivery"
import os, requests r = requests.post( "https://xtrack.mcwoms.com/api/v1/trackings", headers={"X-API-Key": os.environ["XTRACK_KEY"]}, json={"trackings": [{"tracking_number": "00340434161094000019"}]}, timeout=30, ) r.raise_for_status() print(r.json()["trackings"][0]["status"]) # out_for_delivery
从免费开始,按单量升级
额度按「每月不同单号数」计,网页与 API 共用。
常见问题
查询要收费吗?
不用。访客每天可以查 30 个不同的单号;免费注册后每月 100 个,并且可以使用 API。单量更大再考虑付费套餐。
为什么有的承运商只给官网链接?
我们只对真正接通数据源的承运商返回轨迹。其余承运商能识别单号,但不会用猜测或过期数据糊弄你,所以直接给官网查询链接。
额度是怎么计算的?
按「一个月内查过多少个不同的单号」计,而不是按查询次数。同一个单号当月反复查询只算一次;识别不了或未接入的单号不计额度。
轨迹多久更新一次?
在途包裹的结果缓存 30 分钟,期间重复查询直接返回缓存;已签收的包裹不再变化,缓存更久。每条结果都标明了更新时间。
我的查询会被保存吗?
我们保存单号与轨迹用于缓存,保存查询流水用于统计与排障(90 天)。访客 IP 只保存加盐哈希,用于限流,无法还原。