短附录:看懂样例中的描述、时间与照片
把事件主描述与补充信息放在一起读
一段轨迹可能按最新在前排列:Delivered 在最上方,下面依次保留较早的 Out for Delivery、Arrival at Destination Facility、In transit to destination facility、Processing at Designated Facility 和 Shipping Label Created。较早的运输记录仍然存在,不表示包裹已经从送达“退回”运输中。
API 结果中,eventDescription 可以是 Delivered,eventSupplementalInfo 可以是 Position: Front door,而 description 则将两者连起来显示。只提取 Delivered,会丢掉最有助于找包裹的位置说明。客服转述也应保留补充原因,而不只复制大类状态。 API 示例
UTC 时间、当地日期和空值各代表什么
示意例子:事件的 ts 为 2026-06-02T01:30:00Z,localTs 为 2026-06-01T20:30:00-05:00。这是同一时刻,当地日期比 UTC 早一天,不是重复投递。示例只用于说明格式;实际排序要按有明确时区的时间统一比较,并结合 timeZone,不要只比当地小时。
查询层的 SUCCESS 或 success 表示查询结果,不是投递结果;还要看每票是否返回错误以及事件内容。edd 为 null 只说明这次没有可用的预计送达值,不能据此判断丢失。occurredAt 为空也不能覆盖已有的 ts 和 localTs。不同字段是否返回,要以该次响应为准。 API 示例
某个事件没有照片,不等于整票没有 POD
返回内容可以同时存在整票层级的 pods 和事件层级的 pods。某个事件里是 null 时,还要查看整票是否有可用照片;反过来,字段里有照片链接也不代表你已经证明本人签收。普通收件人使用官方查件页和 ZIP 查看即可,不需要获取 API 密钥,也不应公开原始照片链接、住址、定位或账号信息。 API 示例
这段附录用于理解返回结果,不要求普通收件人接入接口。技术团队可查看 SpeedX Get Tracking 文档;对外解释应围绕实际事件与动作,不把查询成功、空字段或列表顺序改写成物流结论。
如果你是卖家或 3PL,需要把承运事件同步到订单或仓库系统,可以查看如何用 Tracking API 管理批量运单轨迹。