createSubscription

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/notifications/v1/subscriptions/{notificationType}

为指定的通知类型创建一个订阅，以便将通知发送到指定的目标。您必须先通过调用 createDestination 操作创建目标，然后才能订阅。如果您指定的通知类型支持多个有效负载版本，并且您已有针对不同有效负载版本的现有订阅，则可以使用此操作订阅不同的有效负载版本。

使用计划：

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

x-amzn-RateLimit-Limit 响应头包含操作的使用计划速率限制（如果可用）。上表包含此操作的默认速率和突发值。业务需求较高的销售合作伙伴可能具有比此处显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

Body 参数application/json必填

示例

{
    "payloadVersion": "string",
    "destinationId": "string",
    "processingDirective": {
        "eventFilter": {
            "aggregationSettings": {
                "aggregationTimePeriod": "FiveMinutes"
            },
            "marketplaceIds": [
                "string"
            ],
            "orderChangeTypes": [
                "BuyerRequestedChange"
            ],
            "trackingIdentifier": {
                "id": "string",
                "carrierTracking": {
                    "trackingNumber": "string",
                    "carrierCode": "string"
                },
                "acsin": "string",
                "aftn": "string",
                "containerNumber": "string",
                "houseBillOfLadingNumber": "string"
            },
            "eventFilterType": "ANY_OFFER_CHANGED"
        },
        "filterExpression": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/notifications/v1/subscriptions/' \
--header 'Content-Type: application/json' \
--data '{
    "payloadVersion": "string",
    "destinationId": "string",
    "processingDirective": {
        "eventFilter": {
            "aggregationSettings": {
                "aggregationTimePeriod": "FiveMinutes"
            },
            "marketplaceIds": [
                "string"
            ],
            "orderChangeTypes": [
                "BuyerRequestedChange"
            ],
            "trackingIdentifier": {
                "id": "string",
                "carrierTracking": {
                    "trackingNumber": "string",
                    "carrierCode": "string"
                },
                "acsin": "string",
                "aftn": "string",
                "containerNumber": "string",
                "houseBillOfLadingNumber": "string"
            },
            "eventFilterType": "ANY_OFFER_CHANGED"
        },
        "filterExpression": "string"
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

Body

示例

{
    "payload": {
        "subscriptionId": "string",
        "payloadVersion": "string",
        "destinationId": "string",
        "processingDirective": {
            "eventFilter": {
                "aggregationSettings": {
                    "aggregationTimePeriod": "FiveMinutes"
                },
                "marketplaceIds": [
                    "string"
                ],
                "orderChangeTypes": [
                    "BuyerRequestedChange"
                ],
                "trackingIdentifier": {
                    "id": "string",
                    "carrierTracking": {
                        "trackingNumber": "string",
                        "carrierCode": "string"
                    },
                    "acsin": "string",
                    "aftn": "string",
                    "containerNumber": "string",
                    "houseBillOfLadingNumber": "string"
                },
                "eventFilterType": "ANY_OFFER_CHANGED"
            },
            "filterExpression": "string"
        }
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2026-08-27 14:13:57

getSubscription

getSubscriptionById