跳轉到主要內容

​
身份驗證

所有 Flex Forward API 端點都需要在 Authorization 標頭中使用 Bearer 令牌 進行身份驗證。

​
取得 API 令牌

API 存取令牌由 Flex Forward 團隊在建置或帳戶核准時發放。如需申請開發或正式環境的存取權限，請聯繫 [email protected]。
請妥善保管您的 API 令牌。請勿在客戶端程式碼、公開儲存庫或不安全的管道中分享。

​
存取方式

Flex Forward 採用託管式建置模型。API 存取由 Flex Forward 團隊提供，以確保您的帳戶針對物流路線和物流業者需求正確設定。
1

聯繫 Flex Forward 團隊

將您的使用場景、預期配送量和所需物流路線以電子郵件發送至 [email protected]。
2

接收開發環境存取權限

團隊將提供您的開發環境認證資訊，並設定您的配送帳戶以在物流業者沙盒服務上進行測試。
3

測試您的整合

使用開發環境建置並驗證您的整合。確認標籤建立、文件取得和追蹤功能正常。
4

申請正式環境存取權限

測試成功後，申請正式環境認證資訊。團隊將確認準備就緒並提供正式環境存取權限。

​
關於 shipperAccountId

shipperAccountId 是識別您已設定的配送帳戶的 UUID（例如 a1b2c3d4-e5f6-7890-abcd-ef1234567890）。由 Flex Forward 團隊在建置時提供，並連結至您的物流業者和物流路線設定。單一 API 帳戶可以擁有多個 shipperAccountId 以對應不同的物流業者設定。

​
發送已驗證的請求

在每個請求的 Authorization 標頭中包含令牌： 
curl -X POST https://api.flexforward.com/labels \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "ord-20250301-abc123",
    "courier": "yunexpress",
    "service": {
      "shipperAccountId": "your-account-id",
      "productCode": "YEXP01"
    },
    "shipment": { ... }
  }'

​
錯誤回應

令牌缺失或無效時，API 回傳 401 Unauthorized 回應： 
{
  "error": "Unauthorized"
}
令牌有效但呼叫者無權存取請求的資源時，API 回傳 403 Forbidden 回應： 
{
  "error": "Forbidden"
}

​
令牌最佳實踐

  • 定期輪換令牌
  • 開發和正式環境使用個別的令牌
  • 將令牌存放在環境變數或密鑰管理器中 — 切勿寫死