​

變更記錄

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 令牌認證，正式與開發環境使用獨立令牌
• 文件： 快速入門指南、認證參考、錯誤處理指南、冪等性與重試模式、環境詳情、核心概念、版本管理政策、常見問題