跳轉到主要內容
GET
以標籤 ID 或客戶訂單編號取得物流業者託管的標籤 URL

授權

x-rr-apikey
string
header
必填
x-rr-apitoken
string
header
必填

路徑參數

id
string
必填

標籤 UUID、客戶訂單編號或以逗號分隔的識別碼。

Minimum string length: 1

回應

所請求識別碼對應的標籤文件 URL。單一識別碼回傳 GetLabelResponse;以逗號分隔的多個識別碼回傳 GetLabelsResponse。

所請求識別碼對應的標籤文件 URL。單一識別碼回傳 GetLabelResponse;以逗號分隔的多個識別碼回傳 GetLabelsResponse。

id
string<uuid>
必填

標籤識別碼。

範例:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

customerOrderNumber
string
必填

此標籤的客戶訂單編號:若有提供則為 order.customerOrderNumber 的值,若未提供則為系統產生的值。

Minimum string length: 1
範例:

"N2026-05-13-TEST-01"

url
string<uri>
必填

標籤文件下載 URL。

範例:

"https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf"

labelFormat
string
必填

小寫的文件格式(pdf 或 png),對應建立時請求的 label.format。

Minimum string length: 1
範例:

"pdf"