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

​
取得標籤文件

建立配送標籤後，使用 GET /labels/{id} 取得可列印的航空提單文件。傳入單一識別碼或以逗號分隔的多個識別碼即可進行批次取得。本指南涵蓋取得流程、批次請求、文件格式及實務注意事項。

​
取得文件 URL

使用標籤建立回應中的 id： 
curl https://api.flexforward.com/labels/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
回應

200 OK
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "customerOrderNumber": "N2026-05-13-TEST-01",
  "url": "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf",
  "labelFormat": "pdf"
}
欄位說明
id標籤的 UUID（與請求參數相同）。
customerOrderNumber與此標籤關聯的客戶訂單編號。
url航空提單文件的直接下載 URL。
labelFormat文件格式：pdf 或 png。

​
下載並列印

從回傳的 url 下載文件： 
curl -o label.pdf "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf"

​
文件行為

  • 永久 URL — 文件 URL 不會過期。您可以儲存 URL 並隨時下載文件。
  • 格式 — 文件以 PDF 或 PNG 提供，取決於物流業者和標籤設定。
  • 重新取得 — 多次呼叫 GET /labels/{id} 會回傳相同的 URL。此端點本質上具有冪等性。

​
批次取得

透過傳入以逗號分隔的識別碼，即可在單一請求中取得多個標籤文件。您可以混合使用標籤 UUID 和客戶訂單編號。 
curl "https://api.flexforward.com/labels/f47ac10b-58cc-4372-a567-0e02b2c3d479,N2026-05-13-TEST-02" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
批次回應

200 OK
{
  "labels": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "customerOrderNumber": "N2026-05-13-TEST-01",
      "url": "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf",
      "labelFormat": "pdf"
    },
    {
      "id": "c8d9e0f1-2345-6789-abcd-ef0123456789",
      "customerOrderNumber": "N2026-05-13-TEST-02",
      "url": "https://label-cdn.yunexpress.cn/labels/YT2503010002.pdf",
      "labelFormat": "pdf"
    }
  ]
}
欄位說明
labels成功解析的標籤文件陣列。找不到或失敗的標籤會被省略。
labels[].id標籤的 UUID。
labels[].customerOrderNumber與此標籤關聯的客戶訂單編號。
labels[].url航空提單文件的直接下載 URL。
labels[].labelFormat文件格式：pdf 或 png。
找不到或失敗的標籤會從回應中被靜默省略。請將回傳的 labels 陣列與您請求的識別碼進行比對，以偵測未成功解析的項目。

​
錯誤處理

狀態碼意義處理方式
200已取得文件 URL從 url 欄位下載
403存取被拒該標籤屬於其他帳戶
404找不到標籤請確認標籤 ID 是否正確
502上游服務錯誤使用指數退避重試

​
後續步驟

追蹤出貨

列印並貼附標籤後，監控出貨進度。

錯誤處理

所有 HTTP 狀態碼和錯誤回應格式的完整參考。