创建配送标签
为指定的物流商和货件详情创建配送标签。支持幂等创建 — 使用相同 idempotencyKey 重发请求将以 HTTP 200 返回原始结果,而不创建重复标签。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
创建配送标签的请求载荷。
创建配送标签的请求载荷。
客户端生成的唯一密钥,用于确保幂等标签创建。使用相同密钥重发请求将返回原始结果。
1 - 100"unique-key-per-request"
要使用的物流商代码。调用 GET /couriers 以列出您账户可用的有效物流商代码,然后传入其中一个返回的 code 值。
1"yunexpress"
物流商服务配置。
包含发件地、目的地及包裹的货件详情。
标签输出偏好设置。
重量与尺寸的计量单位。
订单参考信息。
跨境货件的报关信息。
以代码与值配对方式提供的额外服务选项。
危险品申报。
取件点配置。
物流商专属选项。
响应
标签创建请求的结果。
标签创建请求的结果。
唯一标签标识符。
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
标签创建结果 — created 或 failed。
created "created"
使用的物流商。
"yunexpress"
与此标签关联的客户订单编号。
"N-2026-05-27-TEST-03"
物流商分配的订单编号,失败时为 null。
"YT2503010001"
物流商分配的追踪编号,尚未获取时为 null。
"YT2503010001CN"
标签创建失败时的错误详情,否则为 null。