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 状态码和错误响应格式的完整参考。