retrieveShippingLabel - Amazon Selling Partner API (SP-API)-中文

根据运输 ID 和跟踪 ID 检索运输标签。

使用计划：

速率（每秒请求）	突发
5	15

有关更多信息，请参见销售合作伙伴 API 文档中的“使用计划和速率限制”。

请求参数

Path 参数

shipmentId

string

必需

trackingId

string

必需

Body 参数application/json

retrieveShippingLabel 操作的请求架构。

labelSpecification

object (LabelSpecification)

标签规格信息。

必需

labelFormat

enum<string>

必需

标签的格式。目前仅支持PNG的枚举。

枚举值:

PNG

labelStockSize

enum<string>

必需

标签库存尺寸规格，包括长度和高度。目前仅支持4x6的枚举。

枚举值:

4x6

示例

{
    "labelSpecification": {
        "labelFormat": "PNG",
        "labelStockSize": "4x6"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

独特请求参考ID。

可选

Body

retrieveShippingLabel 操作的响应模式。

payload

object (RetrieveShippingLabelResult)

可选

检索运输标签操作的有效负载模式。

labelStream

string

必需

包含以 base-64 字符串编码的二进制图像数据。

labelSpecification

object (LabelSpecification)

标签规格信息。

必需

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个识别所发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
    "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)",
    "labelSpecification": {
        "labelFormat": "PNG",
        "labelStockSize": "4x6"
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障