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

向买家发送消息，以分享使用其订单中数字内容所需的数字访问密钥。

使用计划：

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

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如果可用）。上表指示该操作的默认速率和突发值。其业务需求需要更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

amazonOrderId

string

必需

亚马逊订单标识符。这指定了发送消息的订单。

Query 参数

marketplaceIds

array[string]

必需

一个市场标识符。它指定了下单的市场。只能指定一个市场。

<= 1 items

Body 参数application/json

createDigitalAccessKey 操作的请求架构。

text

string

可选

要发送给买家的文本。仅允许与数字访问密钥相关的链接。请勿包含HTML或电子邮件地址。文本必须用买家的首选语言编写，可以通过GetAttributes操作获取。

>= 1 字符<= 400 字符

attachments

array[object (Attachment) {2}]

可选

包括在信息中发送给买家的附件。

uploadDestinationId

string

必需

上传目标的标识符。通过调用上传 API 的 createUploadDestinationForResource 操作获取此值。

fileName

string

必需

文件的名称，包括扩展名。这是消息中将出现的文件名。它不需要与您上传的文件的文件名匹配。

示例

{
    "text": "string",
    "attachments": [
        {
            "uploadDestinationId": "string",
            "fileName": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201成功

application/hal+json

该消息是为订单创建的。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

object {0}

示例

{}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障