跳轉到主要內容
此頁面由英文翻譯而成。英文版為官方權威來源。如翻譯內容有任何不一致之處,請以英文版為準。

Flex Forward API

Flex Forward 提供單一 API 來建立配送標籤、取得提單文件,以及追蹤貨件。透過統一的請求格式、正規化的追蹤資料與內建冪等性,一次整合即可對接多個物流業者。

核心工作流程

建立標籤

透過支援的物流業者建立配送標籤,支援冪等請求。

取得標籤文件

取得已建立標籤的提單 PDF。

貨件追蹤

以統一格式取得所有物流業者的即時追蹤資訊。

三步驟開始

1

取得 API 存取權限

請至 Return Helper User Portal(Settings → Signing Key and API Token)取得 API 金鑰與 API 令牌,或聯絡 [email protected] 尋求協助。
2

建立您的第一個標籤

發送包含配送資訊的 POST /labels 請求。API 將回傳標籤 ID 和追蹤號碼。
3

取得文件並追蹤

使用標籤 ID 取得提單文件(GET /labels/{id})並追蹤貨件(GET /tracking/{id})。

按照快速入門指南操作

從身份驗證到建立第一個標籤的逐步指南。

整合流程

第一個請求範例

201 Created

正式環境支援範圍

Flex Forward 目前支援透過 YunExpress 進行正式環境的配送,涵蓋全球跨境電商物流。 可根據物流路線需求及帳戶建置來啟用額外的物流業者。如需了解物流業者的可用性,請聯繫 Flex Forward 團隊。

環境

所有 API 請求必須透過 HTTPS 發送。開發環境連接至物流業者的沙盒服務,可安全進行測試。

環境詳情

認證資訊分離、環境行為與營運注意事項。
Flex Forward 可能在不事先通知的情況下於 API 回應中新增欄位。請勿以嚴格綱要驗證回應 — 請忽略未知欄位,並妥善處理未知的列舉值。詳見版本管理。

平台可靠性

身份驗證

API 金鑰與令牌標頭驗證,以及認證資訊管理最佳實踐。

錯誤處理

HTTP 狀態碼、錯誤回應格式與疑難排解指南。

冪等性與重試

防止重複建立標籤並安全地重試請求。

版本管理

API 如何處理變更與向後相容性。

OpenAPI 規格

下載 OpenAPI 規格

下載 OpenAPI 3.1 規格以用於程式碼生成、客戶端 SDK 和 API 工具。

支援

如需建置協助、整合支援或物流業者可用性諮詢,請聯繫 Flex Forward 團隊:[email protected]

支援與常見問題

技術支援、建置指南與常見問題。