此頁面由英文翻譯而成。英文版為官方權威來源。如翻譯內容有任何不一致之處,請以英文版為準。
取得標籤文件
建立配送標籤後,使用GET /labels/{id} 取得可列印的航空提單文件。傳入單一識別碼或以逗號分隔的多個識別碼即可進行批次取得。本指南涵蓋取得流程、批次請求、文件格式及實務注意事項。
取得文件 URL
使用標籤建立回應中的id:
回應
200 OK
下載並列印
從回傳的url 下載文件:
文件行為
- 永久 URL — 文件 URL 不會過期。您可以儲存 URL 並隨時下載文件。
- 格式 — 文件以 PDF 或 PNG 提供,取決於物流業者和標籤設定。
- 重新取得 — 多次呼叫
GET /labels/{id}會回傳相同的 URL。此端點本質上具有冪等性。
批次取得
透過傳入以逗號分隔的識別碼,即可在單一請求中取得多個標籤文件。您可以混合使用標籤 UUID 和客戶訂單編號。批次回應
200 OK
找不到或失敗的標籤會從回應中被靜默省略。請將回傳的
labels 陣列與您請求的識別碼進行比對,以偵測未成功解析的項目。錯誤處理
後續步驟
追蹤出貨
列印並貼附標籤後,監控出貨進度。
錯誤處理
所有 HTTP 狀態碼和錯誤回應格式的完整參考。