产品概述
对接物流轨迹是个又脏又累的活:每家承运商的状态码体系都不一样,字段命名、状态粒度、推送格式各成一套。接十家承运商,往往要写十套解析逻辑,还得长期维护各家的接口变更。
OLTS(Open Logistics Tracking Schema)用一份开放规范解决这件事:把国内 10 家 + 国际 4 家承运商共 1761 条原始状态码,归一到 32 个 ULSC(Unified Logistics Status Code)统一状态码。开发者只需理解这一套统一模型,就能消费全网承运商的轨迹数据。
规范配套机器可直接消费的 JSON Schema、OpenAPI 3.1、AsyncAPI 2.6 与 Webhook 定义,并提供 Python 与 TypeScript 两套零依赖参考 SDK,以 Apache 2.0 / CC BY 4.0 协议开源。
适用对象
- 需要聚合多家承运商轨迹的电商 / 物流平台开发者
- 做物流可视化、履约监控、异常预警的技术团队
- 希望以统一模型沉淀轨迹数据资产的企业
功能要点
每一项都对应一个具体的业务动作。
14 家承运商映射
覆盖国内 10 家 + 国际 4 家,1761 条原始状态码全部映射到统一模型。
32 个 ULSC 统一码
把碎片化状态归一到一套语义清晰、机器可判定的统一状态码。
完整接口规范
提供 JSON Schema、OpenAPI 3.1、AsyncAPI 2.6 与 Webhook 定义,机器可直接消费。
双语言零依赖 SDK
Python 与 TypeScript 两套参考实现,零运行时依赖,开箱即用。
开源开放
代码 Apache 2.0、规范文档 CC BY 4.0,社区可自由使用与共建。
典型使用场景
多承运商轨迹聚合
一次对接 OLTS 统一模型,即可消费 14 家承运商的轨迹,无需为每家单独写解析与映射。
履约状态监控
基于 32 个 ULSC 统一码做跨承运商的状态统计、时效分析与异常预警。
系统间数据交换
用 JSON Schema / OpenAPI / AsyncAPI 在内部系统与合作方之间传递结构一致的轨迹数据。
常见问题
OLTS 是产品还是规范?
它是一份开放规范 + 参考 SDK,不是 SaaS 产品。你把它集成进自己的系统来归一化轨迹数据。
支持哪些承运商?
当前覆盖国内 10 家、国际 4 家共 14 家承运商,状态码持续随社区维护扩展。
用什么语言可以接入?
官方提供 Python 与 TypeScript 零依赖 SDK,其它语言可直接依据 JSON Schema / OpenAPI 自行实现。
授权协议是什么?
参考实现代码采用 Apache 2.0,规范文档采用 CC BY 4.0,可商用。