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

根据给定的费率购买运输标签。

使用计划：

费率（每秒请求数）	突发
5	15

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

请求参数

Path 参数

shipmentId

string

必需

Body 参数application/json

购买标签操作的请求架构。

rateId

string

评级的标识符。

必需

labelSpecification

object (LabelSpecification)

标签规格信息。

必需

labelFormat

enum<string>

必需

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

枚举值:

PNG

labelStockSize

enum<string>

必需

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

枚举值:

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

purchaseLabels 操作的响应架构。

payload

object (PurchaseLabelsResult)

可选

purchaseLabels操作的有效负载模式。

shipmentId

string

唯一的货物识别码。

必需

clientReferenceId

string

客户参考编号。

可选

<= 40 字符

acceptedRate

object (AcceptedRate)

必需

为该货物运输购买的具体费率，如果未购买则为null。

labelResults

array[object (LabelResult) {3}]

标签结果列表

必需

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

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

details

string

可选

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

示例

{
  "shipmentId": "89108749065090",
  "clientReferenceId": "911-7267646-6348616",
  "acceptedRate": {
    "billedWeight": {
      "value": 4,
      "unit": "kg"
    },
    "totalCharge": {
      "value": 3.5,
      "unit": "GBP"
    },
    "serviceType": "Amazon Shipping Standard",
    "promise": {
      "deliveryWindow": {
        "start": "2018-08-25T20:22:30.737Z",
        "end": "2018-08-26T20:22:30.737Z"
      },
      "receiveWindow": {
        "start": "2018-08-23T09:22:30.737Z",
        "end": "2018-08-23T11:22:30.737Z"
      }
    }
  },
  "labelResults": [
    {
      "containerReferenceId": "CRI123456789",
      "trackingId": "1512748795322",
      "label": {
        "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)",
        "labelSpecification": {
          "labelFormat": "PNG",
          "labelStockSize": "4x6"
        }
      }
    }
  ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障