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

获取最新的车辆系列

请求参数

Query 参数

pageToken

string

可选

一个令牌，用于在存在多个结果页面时获取特定页面。

示例值:

sdlkj234lkj234lksjdflkjwdflkjsfdlkj234234234234

marketplaceId

string

必需

资源所在市场的标识符。

示例值:

A1PA6795UKMFR9

vehicleType

enum<string>

车辆类型的标识符。

必需

枚举值:

CARMOTORBIKE

示例值:

CAR

updatedAfter

string

可选

如果提供日期，以ISO 8601格式输入，则仅返回在此日期之后修改/添加到亚马逊目录的车辆。

示例值:

2024-01-05T18:00:03+00:00

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功。

application/json

Body

获取亚马逊目录中车辆的分页列表

pagination

object (Pagination)

可选

当请求产生的响应超过 pageSize 时，会发生分页。这意味着响应被划分为单独的页面。要检索下一页或上一页，您必须在下一个请求中将 nextToken 值或 previousToken 值作为 pageToken 参数传递。当您收到最后一页时，分页对象中将没有 nextToken 键。

nextToken

string

可选

可以用来获取下一页的令牌。

previousToken

string

可选

一个可以用来获取上一页的令牌。

vehicles

array[object (Vehicle) {12}]

必需

亚马逊目录中的车辆列表。

make

string

车辆品牌。

必需

model

string

特定型号的车辆。

必需

variantName

string

车辆类型名称。

可选

bodyStyle

string

可选

车辆的车身风格（例如：掀背车，敞篷车）。

driveType

string

可选

驱动形式（例如：后驱）。

energy

string

可选

车辆的能源来源（例如：汽油）

engineOutput

array[object (EngineOutput) {2}]

车辆的发动机输出

可选

>= 1 items

manufacturingStartDate

object (MonthAndYear)

可选

表示特定年份的一个月。

manufacturingStopDate

object (MonthAndYear)

可选

表示特定年份的一个月。

lastProcessedDate

string

可选

车辆最后更新时间，以 ISO-8601 日期/时间格式表示。

status

enum<string>

可选

亚马逊目录中车辆的状态。

枚举值:

ACTIVEDELETED

identifiers

array[object (VehicleIdentifiers) {2}]

必需

可以用来唯一识别车辆的标识符

>= 1 items

示例

{
  "pagination": {
    "nextToken": "xsdflkj324lkjsdlkj3423klkjsdfkljlk2j34klj2l3k4jlksdjl234",
    "previousToken": "mmkjsdflkj234lkjds234234lkjl234lksjdflkj234234lkjsfsdflkj333d"
  },
  "vehicles": [
    {
      "make": "Chevrolet",
      "model": "Aveo",
      "variantName": "1.2",
      "bodyStyle": "Schrägheck",
      "driveType": "Frontantrieb",
      "energy": "Benzin",
      "engineOutput": [
        {
          "value": 51,
          "unit": "KILOWATT"
        },
        {
          "value": 69,
          "unit": "HORSEPOWER"
        }
      ],
      "manufacturingStartDate": {
        "year": 2011,
        "month": 3
      },
      "manufacturingStopDate": [],
      "lastProcessedDate": "2024-09-01T18:00:03+00:00",
      "status": "DELETED",
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "9997"
        }
      ]
    }
  ]
}

🟠400请求缺少或无效的参数，无法解析。

🟠403表示禁止访问该资源。可能的原因包括访问被拒绝、未经授权、令牌过期或签名无效。

🟠404指定的资源不存在。

🟠413请求大小超过了最大接受大小。

🟠415请求负载格式不受支持。

🟠429请求的频率超过了允许的范围。

🔴500发生了意外情况，导致服务器无法完成请求。

🔴503服务器的临时超载或维护。