createQuery

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/dataKiosk/2023-11-15/queries

创建一个数据亭查询请求。

注意： 查询的保留时间根据请求的字段而异。架构中的每个字段都带有一个 @resultRetention 指令，该指令定义了包含该字段的查询将被保留多长时间。当查询包含多个保留时间不同的字段时，将应用最短（最小）保留时间。查询结果文档的保留时间始终与查询的保留时间相匹配。

使用计划：

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

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

请求参数

Body 参数application/json

示例

{
    "query": "string",
    "paginationToken": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/dataKiosk/2023-11-15/queries' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "string",
    "paginationToken": "string"
}'

返回响应

🟢202成功

application/json

成功。

Headers

Body

示例

{
    "queryId": "string"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-06-15 14:54:21

getQueries

cancelQuery