createReservation

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/service/v1/reservation

创建一个预约。

使用计划：

速率（每秒请求数）	峰值
5	20

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

请求参数

Query 参数

Body 参数application/json

示例

{
    "resourceId": "string",
    "reservation": {
        "reservationId": "string",
        "type": "APPOINTMENT",
        "availability": {
            "startTime": "2019-08-24T14:15:22Z",
            "endTime": "2019-08-24T14:15:22Z",
            "recurrence": {
                "endTime": "2019-08-24T14:15:22Z",
                "daysOfWeek": [
                    "MONDAY"
                ],
                "daysOfMonth": [
                    1
                ]
            },
            "capacity": 1
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/service/v1/reservation?marketplaceIds' \
--header 'Content-Type: application/json' \
--data-raw '{
    "resourceId": "string",
    "reservation": {
        "reservationId": "string",
        "type": "APPOINTMENT",
        "availability": {
            "startTime": "2019-08-24T14:15:22Z",
            "endTime": "2019-08-24T14:15:22Z",
            "recurrence": {
                "endTime": "2019-08-24T14:15:22Z",
                "daysOfWeek": [
                    "MONDAY"
                ],
                "daysOfMonth": [
                    1
                ]
            },
            "capacity": 1
        }
    }
}'

返回响应

🟢200成功

application/json

成功响应。

Headers

Body

示例

{
    "payload": {
        "reservation": {
            "reservationId": "string",
            "type": "APPOINTMENT",
            "availability": {
                "startTime": "2019-08-24T14:15:22Z",
                "endTime": "2019-08-24T14:15:22Z",
                "recurrence": {
                    "endTime": "2019-08-24T14:15:22Z",
                    "daysOfWeek": [
                        "MONDAY"
                    ],
                    "daysOfMonth": [
                        1
                    ]
                },
                "capacity": 1
            }
        },
        "warnings": [
            {
                "code": "string",
                "message": "string",
                "details": "string"
            }
        ],
        "errors": [
            {
                "code": "string",
                "message": "string",
                "details": "string",
                "errorLevel": "ERROR"
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string",
            "errorLevel": "ERROR"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-06-15 14:55:06

updateSchedule

updateReservation