跳转到主要内容
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"