跳轉到主要內容

​
取得標籤文件

建立配送標籤後，使用 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",
  "url": "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf",
  "labelFormat": "pdf"
}
欄位說明
id標籤的 UUID（與請求參數相同）。
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。此端點本質上具有冪等性。

​
錯誤處理

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

​
後續步驟

追蹤出貨

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

錯誤處理

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