Skip to main content
此頁面由英文翻譯而成。英文版為官方權威來源。如翻譯內容有任何不一致之處,請以英文版為準。

取得標籤文件

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

取得文件 URL

使用標籤建立回應中的 id

回應

200 OK

下載並列印

從回傳的 url 下載文件:

文件行為

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

批次取得

透過傳入以逗號分隔的識別碼,即可在單一請求中取得多個標籤文件。您可以混合使用標籤 UUID 和客戶訂單編號。

批次回應

200 OK
找不到或失敗的標籤會從回應中被靜默省略。請將回傳的 labels 陣列與您請求的識別碼進行比對,以偵測未成功解析的項目。

錯誤處理

後續步驟

追蹤出貨

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

錯誤處理

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