Информация об установленных ставках
Возвращает значения ставок для заданных товаров.
В ответе возвращаются значения только тех ставок, которые вы установили через запрос PUT businesses/{businessId}/bids. Получить информацию по кампаниям, созданным в кабинете, не получится.
В одном запросе может быть максимум 1500 товаров.
| ⚙️ Лимит: 1000 запросов в минуту |
|---|
Request
POST
https://api.partner.market.yandex.ru/businesses/{businessId}/bids/info
Path parameters
|
Name |
Type |
Description |
|
businessId* |
integer<int64> |
Идентификатор кабинета. Чтобы узнать идентификатор, воспользуйтесь запросом GET campaigns. |
Query parameters
|
Name |
Type |
Description |
|
page_token |
string |
Идентификатор страницы c результатами. Если параметр не указан, возвращается самая старая страница. Рекомендуется передавать значение выходного параметра Если задан |
|
limit |
integer<int32> |
Количество товаров на одной странице.
|
Body
{
"skus": [
"string"
]
}
|
Name |
Type |
Description |
|
skus |
string[] |
Список товаров, для которых нужно получить значения ставок. Если список не задан, постранично возвращаются все товары со ставками. Если список задан, результаты возвращаются одной страницей, а параметры Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы Правила использования SKU:
Что такое SKU и как его назначать
|
Responses
200 OK
Значения ставок для заданных товаров. В ответ попадают только товары, на которые установлены ставки.
Body
{
"status": "OK",
"result": {
"bids": [
{
"sku": "string",
"bid": 570
}
],
"paging": {
"nextPageToken": "string"
}
}
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
result |
Список товаров с указанными ставками. |
GetBidsInfoResponseDTO
Список товаров с указанными ставками.
|
Name |
Type |
Description |
|
bids* |
Страница списка товаров. |
|
|
paging |
Ссылка на следующую страницу. |
SkuBidItemDTO
Список товаров и ставок на них.
|
Name |
Type |
Description |
|
sku* |
string |
SKU товара, которому соответствует ставка из параметра |
|
bid* |
integer<int32> |
Значение ставки для товара из параметра Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500.
|
ForwardScrollingPagerDTO
Ссылка на следующую страницу.
|
Name |
Type |
Description |
|
nextPageToken |
string |
Идентификатор следующей страницы результатов. |
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 |
Список ошибок. |