Create an action plan.

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/actionPlans/2026-06-01/plans

基于模板创建行动计划。使用 mode=PREVIEW 可返回计划而不创建或执行。省略 mode 则创建计划并提交执行。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "planTemplateId": "CROSS_STORE_EXPANSION_FBA",
    "actionItem": {
        "actionItemId": "ebf5caf1-8cfb-43bd-a13b-ef91bdb0d930",
        "resolution": {
            "definition": {
                "resolutionDefinitionId": "CROSS_STORE_EXPANSION_FBA"
            }
        }
    },
    "inputs": {
        "sourceMarketplaceId": {
            "value": [
                "A1PA6795UKMFR9"
            ]
        },
        "targetMarketplaceId": {
            "value": [
                "A13V1IB3VIYZZH"
            ]
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/actionPlans/2026-06-01/plans?mode=PREVIEW&locale=en-US' \
--header 'Content-Type: application/json' \
--data '{
    "planTemplateId": "CROSS_STORE_EXPANSION_FBA",
    "actionItem": {
        "actionItemId": "ebf5caf1-8cfb-43bd-a13b-ef91bdb0d930",
        "resolution": {
            "definition": {
                "resolutionDefinitionId": "CROSS_STORE_EXPANSION_FBA"
            }
        }
    },
    "inputs": {
        "sourceMarketplaceId": {
            "value": [
                "A1PA6795UKMFR9"
            ]
        },
        "targetMarketplaceId": {
            "value": [
                "A13V1IB3VIYZZH"
            ]
        }
    }
}'

返回响应

🟢200成功

application/json

如果设置了 mode=PREVIEW，则返回行动计划的预览。否则返回已创建并提交执行的计划。

Headers

Bodyapplication/json

示例

{
    "plan": {
        "actionPlanId": "e5f6a7b8-89ab-cdef-0123-456789abcdef",
        "status": [
            "DRAFT"
        ],
        "displayName": {
            "text": "Expand FBA to DE — Order #12345",
            "locale": "en-US"
        }
    }
}

🟠400请求有误

🟠403禁止访问

🟠409

🟠413

🟠415

🟠429

🔴500服务器错误

🔴503服务器故障

修改于 2026-11-05 00:46:06

Get an action plan.

List action plans.