Изменить количество товара

Обновить количество товара

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 или botTokenquery или телода*Токен бота
secretKeyqueryда*Секретный ключ (альтернатива токену)

* Достаточно либо token/botToken, либо secretKey.

Заголовки:

Content-Type: application/json

Формат ответа:

{ "result": true, "data": ... }
{ "result": false, "message": "текст ошибки" }

Всегда проверяйте result === true перед использованием data.


Параметры тела

ПолеТипОбязательностьОписание
bot_idintegerдаID бота
category_idintegerдаID товара корзины (type = 7)
countintegerдаОстаток на складе, целое число ≥ 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 integercount не целое число ≥ 0
category_id not foundне передан category_id
not foundтовар не найден или не принадлежит этому магазину