产品型号搜索
方法适用于模式DBS.
目前不适用于卖家Market Yandex Go.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
返回有关满足查询中指定的搜索条件的模型的信息。
您可以在一次请求中获取多达100个型号的信息。
对于方法 ：no-translate[GET]：no-translate[v2/models], ：no-translate[GET]：no-translate[v2/models/{modelId}] 和 POSTv2/models 组资源限制生效。 该限制是对模型的总数施加的，使用这些方法请求的信息。
| **⚙️ 限制：**每小时100,000个型号 |
|---|
Request
GET
https://api.partner.market.yandex.ru/v2/models
Query parameters
|
Name |
Description |
|
query* |
Type: string 产品型号名称的搜索查询。 |
|
regionId* |
Type: integer<int64> 区域的ID。 您可以使用请求获取区域ID :no-translate[GET v2/regions]. |
|
currency |
Type: CurrencyType 在搜索结果页面上显示报价的货币。 可能的值:
默认值：使用商店的本国货币（商店原产国的本国货币）。 |
|
page |
Type: integer<int32> 如果方法有 使用它而不是参数 结果页的编号。 与参数一起使用
Default: Max value: |
|
pageSize |
Type: integer<int32> 页面大小。 与参数一起使用
|
CurrencyType
货币代码:
RUR-俄罗斯卢布。UAH-乌克兰格里夫纳。BYR-白俄罗斯卢布。KZT-哈萨克斯坦坚戈。UZS-乌兹别克总和。
|
Type |
Description |
|
Enum: |
Responses
200 OK
有关模型的信息。
Body
application/json
{
"models": [
{
"id": 0,
"name": "string",
"prices": {
"avg": 0,
"max": 0,
"min": 0
}
}
],
"currency": "RUR",
"regionId": 0,
"pager": {
"total": 0,
"from": 0,
"to": 0,
"currentPage": 0,
"pagesCount": 0,
"pageSize": 0
}
}
|
Name |
Description |
|
currency |
Type: CurrencyType 货币代码:
Enum: |
|
models |
Type: ModelDTO[] 产品型号列表。 |
|
pager |
Type: FlippingPagerDTO 分页的模型。 |
|
regionId |
Type: integer<int64> 显示模型提供信息（传递到该区域）的区域的ID。 您可以使用请求通过ID获取有关区域的信息。 GET v2/regions/{regionId}. |
ModelDTO
的产品型号。
|
Name |
Description |
|
id |
Type: integer<int64> 产品型号ID。 |
|
name |
Type: string 产品型号的名称。 |
|
prices |
Type: ModelPriceDTO 有关产品型号价格的信息。 |
FlippingPagerDTO
分页的模型。
|
Name |
Description |
|
currentPage |
Type: integer<int32> 当前页面。 |
|
from |
Type: integer<int32> 页上找到的元素的初始编号。 |
|
pageSize |
Type: integer<int32> 页面大小。 |
|
pagesCount |
Type: integer<int32> 的总页数。 |
|
to |
Type: integer<int32> 页上找到的元素的最终编号。 |
|
total |
Type: integer<int32> 总共找到了多少件物品。 |
ModelPriceDTO
有关产品型号价格的信息。
|
Name |
Description |
|
avg |
Type: number 该模型在该地区的平均报价。 |
|
max |
Type: number 该地区型号的最高报价。 |
|
min |
Type: number 该模型在该地区的最低报价. |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
ApiErrorDTO
一般错误格式。
|
Name |
Description |
|
code* |
Type: string 的错误代码。 |
|
message |
Type: string 错误的描述。 |
ApiResponseStatusType
响应的类型。 可能的值:
OK-没有错误。ERROR-处理请求时发生错误。
|
Type |
Description |
|
Enum: |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
Yandex中的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.