为下游系统或客户通知获取最新的配送状态时使用此端点。以统一格式获取货件的实时追踪状态。标签必须属于已验证的调用者。
追踪数据从物流商服务实时获取,并标准化为包含检查点的一致结构。使用 tag 字段确认高级配送状态。
响应代码: 200 OK — 追踪信息获取成功 · 403 Forbidden — 标签属于其他账户 · 404 Not Found — 标签或配送账户未找到 · 405 Method Not Allowed · 500 Internal Server Error · 502 Bad Gateway — 物流商服务错误。
部署时由 Flex Forward 团队发放的 API 访问令牌。
由创建标签端点返回的标签 ID。
成功获取追踪信息。
标签标识符。
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
物流商分配的追踪编号,尚未获取时为 null。
"YT2503010001CN"
高级追踪状态。可能的值:
Pending、InfoReceived、InTransit、Delivered、Exception、Cancelled、Unknown。
"InTransit"
详细状态子标签。
"InTransit_001"
人类可读的子标签描述。
"In transit"
物流商代码。
"yunexpress"