> ## Documentation Index
> Fetch the complete documentation index at: https://openapidocs.flexforwardship.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 變更記錄

> API 與文件更新資訊

<Note>
  此頁面由英文翻譯而成。[英文版](/introduction)為官方權威來源。如翻譯內容有任何不一致之處，請以英文版為準。
</Note>

# 變更記錄

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