Информация о нескольких моделях
Возвращает информацию о моделях товаров.
В одном запросе можно получить информацию не более чем о 100 моделях.
Для методов GET models
, GET models/{modelId}
и POST models
действует групповое ресурсное ограничение. Ограничение вводится на суммарное количество моделей, информация о которых запрошена при помощи этих методов.
⚙️ Лимит: рассчитывается индивидуально |
---|
Request
POST
https://api.partner.market.yandex.ru/models
Query parameters
Name |
Type |
Description |
regionId* |
integer<int64> |
Идентификатор региона. Идентификатор региона можно получить c помощью запроса GET regions. |
currency |
Валюта, в которой отображаются цены предложений на страницах с результатами поиска. Возможные значения:
Значение по умолчанию: используется национальная валюта магазина (национальная валюта страны происхождения магазина). |
CurrencyType
Коды валют. Возможные значения:
BYR
— белорусский рубль.KZT
— казахстанский тенге.RUR
— российский рубль.UAH
— украинская гривна.
Type |
Description |
Enum: |
Body
{
"models": [
0
]
}
Name |
Type |
Description |
models |
integer<int64>[] |
Список моделей. |
Responses
200 OK
Информация о моделях.
Body
{
"models": [
{
"id": 0,
"name": "string",
"prices": {
"avg": 0,
"max": 0,
"min": 0
}
}
],
"currency": "RUR",
"regionId": 0
}
Name |
Type |
Description |
models |
ModelDTO[] |
Список моделей товаров. |
currency |
Коды валют. Возможные значения:
|
|
regionId |
integer<int64> |
Идентификатор региона, для которого выводится информация о предложениях модели (доставляемых в этот регион). Информацию о регионе по идентификатору можно получить с помощью запроса GET regions/{regionId}. |
ModelDTO
Модель товара.
Name |
Type |
Description |
id |
integer<int64> |
Идентификатор модели товара. |
name |
string |
Название модели товара. |
prices |
Информация о ценах на модель товара. |
ModelPriceDTO
Информация о ценах на модель товара.
Name |
Type |
Description |
avg |
number |
Средняя цена предложения для модели в регионе. |
max |
number |
Максимальная цена предложения для модели в регионе. |
min |
number |
Минимальная цена предложения для модели в регионе. |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Type |
Description |
code* |
string |
Код ошибки. |
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
Суточный лимит зависит от количества:
- предложений на карточках моделей;
- активных магазинов клиента.
Количество предложений считается по данным за последние семь дней (не включая сегодня). Для новых магазинов, еще не разместивших предложения, ограничение равно 0 и пересчитывается на следующий день после размещения первых предложений.
Для клиентов с несколькими магазинами ограничение рассчитывается с учетом количества предложений, являющегося максимальным среди всех магазинов клиента. Для агентств ограничение суммируется по всем субклиентам агентства.