ИИ-агенту отдельный ключ: зачем WB четыре типа API-токенов

Четыре ключа на одну дверь: разница не в металле, а в том, у кого они в руках
Четыре ключа на одну дверь: разница не в металле, а в том, у кого они в руках

Я продаю на Wildberries и Ozon, и за последний год рядом с моим кабинетом появилось то, чего раньше не было: ИИ-агенты. Один помогает собирать описания карточек, второй читает отчёты, третьего я пробовал на ответах в отзывах. Запрос у всех трёх одинаковый: дай доступ в кабинет. И вот здесь выясняется, что доступ в кабинет WB давно перестал быть одним ключом.

Токенов четыре типа, и выбирать надо не по принципу «какой дадут», а по тому, где физически крутится код, которому вы отдаёте ключ. Разберу, чем типы отличаются, что изменилось с лимитами в марте и почему история про ИИ-агентов упирается не в нейросети, а в скучный вопрос, кому принадлежит сервер.

Четыре типа токенов, если коротко

  • Тестовый. Для разработки в песочнице WB API. Реальных данных кабинета не касается.
  • Базовый. Для проверки на реальных данных перед запуском и для случаев, когда ни персональный, ни сервисный не подходят.
  • Персональный. Для ваших собственных программ и коробочных решений на своей или арендованной инфраструктуре. Передавать третьим лицам и использовать в облачных сервисах нельзя.
  • Сервисный. Для конкретного готового облачного сервиса из Каталога решений.

Лимиты развели 30 марта

До марта тип токена был почти формальностью. С 30 марта 2026 года WB развёл лимиты: персональный и сервисный получили 300 запросов в минуту с залпом до 20 запросов без паузы, базовый и тестовый 150 запросов в минуту с залпом до 10. То есть базовый токен теперь работает ровно вдвое медленнее, и это не наказание, а плата за то, что площадка не знает, где он используется.

Посчитал для себя, что это значит на выгрузке контента. Допустим, 5000 карточек и один запрос на карточку. На 300 запросах в минуту полная прогонка займёт около 17 минут, на 150 около 33. Разница в 16 минут сама по себе ничего не стоит, пока вы не ставите цены к старту акции в полночь. На кабинете с 2000 заказов в сутки за эти 16 минут проходит примерно 22 заказа, и если расхождение цены 7% от товара за 1000 рублей, вы отдали 1540 рублей за то, что у интеграции не тот тип ключа. На 200 заказах в сутки это 140 рублей, то есть ерунда. Считайте на своём объёме, а не на моём.

Где здесь ИИ-агент

Классификация WB выглядит бюрократией до того момента, когда вы пытаетесь подключить к кабинету агента. Тип токена это ответ на один вопрос: кто держит ключ в руках.

Агент работает в чужом облаке, вы платите за подписку и общаетесь с ним через браузер или мессенджер: это сервисный токен, и он должен быть выписан под этот конкретный сервис. Агент или скрипт поднят на вашем сервере либо на вашем арендованном VPS, доступ есть только у вас: это персональный токен.

Самый популярный сейчас сценарий ломается именно об это. Человек читает, что к маркетплейсу можно подключить агента по API, идёт в кабинет, выписывает персональный токен как самый мощный по лимитам и вставляет его в поле облачного сервиса. Технически он не ошибся: токен будет работать. Но он нарушил правила WB API, по которым персональный токен запрещено передавать сторонним сервисам, и в случае утечки объясняться придётся ему, а не агенту.

Отдельно отмечу вещь, которая до меня дошла не сразу. Персональный токен не зря отделён от остальных: он даёт доступ к чувствительной информации кабинета. Когда вы вставляете его в чужое окно ввода, вы передаёте не доступ к ценам, а доступ ко всему, что разрешено категориями этого токена, причём бессрочно до отзыва.

Токен это не пароль, а доверенность: в ней написано, кто действует, где и до какого числа.

180 дней это не формальность

Срок в 180 дней выглядит щедрым ровно до первого протухшего токена. Токен, выписанный 1 апреля, умирает 28 сентября, и умирает он молча: интеграция не падает с грохотом, она просто перестаёт получать данные.

Мой расчёт, почему это дороже, чем кажется. Кабинет на 200 заказов в сутки, товар 1000 рублей, маржа 5%, то есть около 10 000 рублей маржи в день. Токен, который питал обновление остатков, перестал работать в пятницу вечером, заметили в понедельник. Три дня вы продавали то, чего, возможно, уже нет на складе, и три дня не управляли ценой. Даже если потеряли пятую часть маржи, это 6000 рублей, плюс отмены по отсутствию товара, которые бьют по рейтингу, а рейтинг деньгами за один день не отыгрывается.

Лечится это тремя строчками в календаре, а не технологиями: дата выдачи каждого токена, дата смерти, ответственный. У меня это обычная таблица, и за прошлый год она окупилась дважды.

Трезвая ложка дёгтя

Было бы удобно считать, что правильный тип токена делает подключение агента безопасным. Не делает. Тип токена говорит площадке, где живёт интеграция, и ничего не говорит о том, насколько она аккуратна. Сервисный токен, выписанный по всем правилам, точно так же позволит агенту перезаписать описания у половины ассортимента, если он получил категорию доступа к контенту и решил, что так лучше.

Поэтому для меня правило простое: типы токенов это про ответственность, а не про защиту. Защита это узкие категории доступа, отдельный токен на каждую интеграцию вместо одного на все и привычка сначала смотреть, что агент собирается изменить, и только потом давать ему право на запись. Настоящая кнопка «стоп» здесь одна: отзыв токена в кабинете.

Что сделать на этой неделе

  • Откройте «Интеграции по API» и выпишите все живые токены с датами. Половина кабинетов, которые я видел, не знает, сколько у них ключей.
  • Найдите токены, которые отданы наружу, и проверьте их тип. Персональный в облачном сервисе надо заменить на сервисный, а не оставлять по принципу «пока работает».
  • Отзовите всё, что досталось от прошлого подрядчика, бывшего менеджера или разового переноса карточек.
  • Поставьте напоминание за две недели до каждого 180-дневного срока. Не на день, а за две недели: перевыпуск требует согласования с тем, кто токен использует.
  • Для интеграций на базовом токене посчитайте, где вам мешают 150 запросов в минуту. Если нигде, не трогайте, это нормальный рабочий вариант.

Про инструменты

Разделение токенов больнее всего чувствуют те, кто работает в чужих кабинетах: фулфилменты, агентства, аутсорс контента. Им нужен доступ без логина и пароля владельца, а теперь ещё и доступ правильного типа. Сервисы, которые подключают кабинет по API, этот сценарий закрывают своей работы: у PIM от TopSeller подключение любого количества кабинетов идёт по API без передачи логинов и паролей владельца, похожая логика у SelSup и у связок через МойСклад. Подойдёт любой инструмент из этого ряда, важен принцип: владелец кабинета выдаёт ключ под конкретный сервис и в любой момент может его отозвать, не меняя себе пароль.

Что до ИИ внутри таких сервисов, я смотрю на одну деталь: заполняет ли он цены и габариты. В том же PIM, по описанию сервиса, нейросеть намеренно не трогает габариты и финансовые характеристики. Это ровно то поведение, которое я хочу видеть от любого агента с доступом к моему кабинету.

Что в итоге

Четыре типа токенов это не усложнение ради усложнения, а попытка площадки понять, кто именно ходит в кабинет: вы, ваша программа или чужой сервис. Волна ИИ-агентов этот вопрос только обострила, потому что агенту всё равно, какой ключ ему дали, а отвечать за выданный ключ будете вы.

Теперь к вам, и лучше цифрами. Сколько живых токенов в вашем кабинете прямо сейчас и знаете ли вы по каждому, что он делает? И если переводили базовый на сервисный, сколько времени ушло на согласование с сервисом?

11