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

创建一个预约。

使用计划：

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

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

请求参数

Query 参数

marketplaceIds

array[string]

必需

资源所在市场的标识符。

<= 1 items

Body 参数application/json

`createReservation` 操作的请求架构。

resourceId

string

必需

资源（商店）标识符。

reservation

object (Reservation)

必需

预订对象减少了资源的容量。

reservationId

string

可选

预订的唯一标识符。如果存在，它将被视为更新预订请求，并将更新相应的预订。否则，它将被视为新的创建预订请求。

type

enum<string>

预订类型。

必需

枚举值:

APPOINTMENTTRAVELVACATIONBREAKTRAINING

availability

object (AvailabilityRecord)

必需

AvailabilityRecord 表示资源在一段时间内的容量。

示例

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功响应。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`createReservation` 操作的响应模式。

payload

object (CreateReservationRecord)

可选

CreateReservationRecord 实体包含 Reservation，如果在对其执行请求操作时出现错误/警告，否则它将包含新的 reservationId。

reservation

object (Reservation)

可选

预订对象减少了资源的容量。

warnings

array[object (Warning) {3}]

可选

API请求成功执行响应中返回的警告列表。

errors

array[object (Error) {4}]

可选

请求失败时返回的错误响应列表。

errors

array[object (Error) {4}]

可选

请求失败时返回的错误响应列表。

示例

{
  "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服务器故障