Обновить количество товара
POST https://api.bot-t.com/v1/shop/category/update-count
Задаёт остаток товара (setting.count) в магазине с корзиной.
Метод доступен только для ботов типа «Магазин с корзиной» (SHOP_CART).
Товар должен быть типа «Товар корзины» (type = 7).
Для цифрового магазина и уникальных строк используйте add-product / subtract-product.
Авторизация
Все методы — POST с телом JSON.
| Параметр | Где | Обязательность | Описание |
|---|---|---|---|
bot_id | тело | да | ID бота в системе BOT-T |
token или botToken | query или тело | да* | Токен бота |
secretKey | query | да* | Секретный ключ (альтернатива токену) |
* Достаточно либо token/botToken, либо secretKey.
Заголовки:
Content-Type: application/json
Формат ответа:
{ "result": true, "data": ... }
{ "result": false, "message": "текст ошибки" }
Всегда проверяйте result === true перед использованием data.
Параметры тела
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
bot_id | integer | да | ID бота |
category_id | integer | да | ID товара корзины (type = 7) |
count | integer | да | Остаток на складе, целое число ≥ 0 |
Пример запроса
POST https://api.bot-t.com/v1/shop/category/update-count?token=BOT_TOKEN
Content-Type: application/json
{
"bot_id": 123,
"category_id": 456,
"count": 10
}
Пример успешного ответа
В data возвращается полный ShopCategoryDto. Остаток лежит в data.setting.count.
{
"result": true,
"data": {
"id": 456,
"category_id": 10,
"type": 7,
"status": 1,
"is_hide": false,
"is_view": true,
"setting": {
"count": 10,
"min_count": 1,
"max_count": 10000,
"is_ban_coupon": false,
"is_change_count": true,
"is_block_feedback": false,
"is_view_ordered_user": false,
"is_check_captcha": false
},
"price": {
"amount": 10000,
"discount": 0,
"old_price": 0
},
"design": {
"title": "Товар"
}
}
}
Ошибки
message | Когда |
|---|---|
Метод доступен только для магазина с корзиной | бот не типа SHOP_CART |
Количество можно менять только у товара корзины | товар не type = 7 |
Count not found | не передан count |
Count must be a non-negative integer | count не целое число ≥ 0 |
category_id not found | не передан category_id |
not found | товар не найден или не принадлежит этому магазину |