此頁面由英文翻譯而成。英文版為官方權威來源。如翻譯內容有任何不一致之處,請以英文版為準。
Flex Forward API
Flex Forward 提供單一 API 來建立配送標籤、取得提單文件,以及追蹤貨件。透過統一的請求格式、正規化的追蹤資料與內建冪等性,一次整合即可對接多個物流業者。核心工作流程
建立標籤
透過支援的物流業者建立配送標籤,支援冪等請求。
取得標籤文件
取得已建立標籤的提單 PDF 或 PNG。
貨件追蹤
以統一格式取得所有物流業者的即時追蹤資訊。
三步驟開始
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 發送。開發環境連接至物流業者的沙盒服務,可安全進行測試。
環境詳情
認證資訊分離、環境行為與營運注意事項。
平台可靠性
身份驗證
API 金鑰與令牌標頭驗證,以及認證資訊管理最佳實踐。
錯誤處理
HTTP 狀態碼、錯誤回應格式與疑難排解指南。
冪等性與重試
防止重複建立標籤並安全地重試請求。
版本管理
API 如何處理變更與向後相容性。
OpenAPI 規格
下載 OpenAPI 規格
下載 OpenAPI 3.1 規格以用於程式碼生成、客戶端 SDK 和 API 工具。
支援
如需建置協助、整合支援或物流業者可用性諮詢,請聯繫 Flex Forward 團隊:[email protected]支援與常見問題
技術支援、建置指南與常見問題。