​

变更记录

Flex Forward API 与文档的重要变更按时间倒序列出。

---

​

2026 年 6 月

​

Added

• 端点： GET /couriers — 列出您账户可用的物流商代码。使用返回的 code 值作为创建标签或列出物流商产品时的 courier。

---

​

2026 年 5 月

​

Added

• 端点： GET /products — 列出物流商可用的配送产品。使用返回的产品代码创建标签。
• 认证： 支持 API 密钥 + 令牌头认证（x-rr-apikey / x-rr-apitoken）作为 Bearer 令牌认证的替代方案。
• 端点： GET /labels/{id} — 现在支持以逗号分隔的标识符（标签 UUID 或客户订单编号）进行批量获取。未找到或失败的标签会从响应中省略。
• 响应： GET /labels/{id} 响应现在包含 customerOrderNumber 字段。

​

Changed

• 破坏性变更： 从标签创建请求中移除 shipperAccountId。此字段不再是 service 对象的必填项。
• API 规格： 为所有端点添加详细描述、示例和操作 ID。
• 文档： 改进快速入门指南、请求示例及其他修正。

---

​

v1.0.0

Flex Forward API 与开发者文档的首次公开发布。

​

Added

• 端点： POST /labels（创建配送标签）、GET /labels/{id}（获取标签文档 URL）、GET /tracking/{id}（获取配送追踪）
• 生产物流商： YunExpress（全球跨境电商配送路线）
• 幂等性： 通过 idempotencyKey 内建标签创建重复防止功能
• 统一追踪： 规范化状态标签（Pending、InfoReceived、InTransit、Delivered、Exception、Cancelled、Unknown）以及跨所有物流商的结构化检查点格式
• 认证： Bearer 令牌认证，生产与开发环境使用独立令牌
• 文档： 快速入门指南、认证参考、错误处理指南、幂等性与重试模式、环境详情、核心概念、版本管理政策、常见问题