Коротко: API-токен — это ключ от вашего кабинета ВБ для программ. Кто держит токен, тот видит ваши продажи и остатки, а с правом записи — меняет цены и ставки и отвечает покупателям от вашего имени. Поэтому три правила: давать только нужные категории, выбирать «только чтение», если сервису не нужно ничего менять, и заводить отдельный токен на каждый сервис. Создаёт токен только владелец профиля, живёт он 180 дней, показывается один раз. Ниже — как создать, какие права выбрать и почему токен перестаёт работать. Порядок — по справке ВБ для продавцов на ноябрь 2026 года.
Что такое API-токен ВБ и зачем он
API — способ, которым программы получают данные магазина без входа в кабинет: заказы, остатки, отчёты, отзывы, рекламу. Токен — длинная строка, которая подтверждает, что программе это разрешено. Он нужен, когда вы подключаете сервис аналитики, систему учёта, автоответы на отзывы, биддер или собственную таблицу.
| Тип | Для чего | Особенности |
|---|---|---|
| Сервисный | Облачный сервис из каталога решений ВБ | Категории подставляются по требованиям сервиса; работает только с ним |
| Персональный | Свои программы и системы на своей инфраструктуре | Расширенный набор категорий; облачным сервисам передавать нельзя |
| Базовый | Проверка на реальных данных и всё, что не подходит под первые два | Часть категорий недоступна |
| Тестовый | Разработка в песочнице | Реальных данных магазина не видит |
Если сервис поддерживает подключение через OAuth 2.0, ВБ советует выбирать его: токен копировать не придётся вовсе.
Как создать токен
- 1.Войдите в кабинет под владельцем профиля: у остальных пользователей раздела нет.
- 2.Профиль → «Интеграции по API» → «+ Создать токен».
- 3.Выберите вкладку: «Для сервиса из каталога» — сервисный токен, «Для интеграции вручную» — персональный, базовый или тестовый.
- 4.Дайте токену название, по которому через полгода поймёте, чей он: «Аналитика — такой-то сервис».
- 5.Отметьте категории данных и уровень доступа: «только чтение» или «чтение и запись».
- 6.Нажмите «Создать» и сразу сохраните токен — в менеджере паролей, а не в заметках и не в чате.
- 7.Вставьте токен в настройки сервиса.
Какие права выбрать: категории и «только чтение»
Категория — это раздел данных, к которому токен открывает доступ. Чем их меньше, тем меньше увидит тот, к кому токен попадёт.
| Категория | Что открывает |
|---|---|
| Контент | Карточки товаров: названия, описания, характеристики, фото |
| Аналитика | Воронка продаж, поисковые запросы, остатки по складам, платное хранение |
| Цены и скидки | Цены, скидки, участие в акциях |
| Маркетплейс | Заказы и остатки на складах продавца: ФБС, DBS и другие модели со своего склада |
| Статистика | Списки заказов и продаж, детализации отчётов |
| Финансы | Финансовые отчёты и баланс; детализации отчётов реализации переезжают сюда |
| Продвижение | Рекламные кампании, ставки, бюджеты, статистика рекламы |
| Вопросы и отзывы | Отзывы и вопросы покупателей и ответы на них |
| Чат с покупателями | Переписка с покупателями |
| Поставки | Поставки на склады ВБ |
| Возвраты покупателями | Заявки покупателей на возврат |
| Документы | Документы из раздела «Документы» кабинета |
| Пользователи | Управление пользователями профиля; только в персональном токене |
- «Только чтение» — сервис видит данные, но ничего не меняет. Для аналитики и отчётов этого достаточно.
- «Чтение и запись» — нужно сервису, который действует за вас: ставит на паузу рекламу, меняет ставки и цены, публикует ответы на отзывы.
- Не больше нужного. ВБ не советует давать персональному и базовому токену больше трёх категорий. Сервисам-комбайнам нужно больше — тем важнее понимать, что именно вы открываете.
Пример — что просит wb2 и зачем. Обязательные категории: «Продвижение» — кампании, ставки и расписания; «Статистика» — заказы и продажи; «Контент» — карточки товаров; «Финансы» — отчёты реализации для расчёта прибыли. По желанию: «Аналитика» — остатки по складам и хранение, «Вопросы и отзывы» и «Чат с покупателями» — ответы покупателям, «Документы» — недельные отчёты, которые не приходят по датам. Запись нужна только тем, кто хочет управлять рекламой, ценами и ответами из сервиса; для отчётов хватает чтения.
Как проверить токен: срок и права
- В кабинете. Карточка токена в «Интеграциях по API»: название, срок действия, уровень доступа, категории. Это единственная проверка, которой стоит доверять.
- В сервисе. Нормальный сервис сам показывает, каких категорий не хватает и не истёк ли срок: эти сведения записаны внутри токена, и читать их можно, не передавая токен дальше.
- Не в «декодерах». Сайт, куда предлагают вставить токен, чтобы «расшифровать» его, получает ваш ключ. Срок и права и так видны в кабинете.
Как обновить и отозвать
- Обновить по сроку. Через 180 дней токен перестаёт работать. За три дня придёт уведомление. Создайте новый с теми же категориями и замените его в сервисе.
- Изменить права. Нельзя: категории и уровень доступа задаются один раз. Нужны другие — новый токен.
- Отозвать. Удалите токен в том же разделе. Доступ пропадёт сразу — у всех систем, которые им пользовались. Поэтому на каждый сервис нужен свой токен: отключаете один, остальные работают.
- Смена владельца. При смене владельца профиля или его номера телефона токены перестают работать корректно — их создают заново.
Кому можно давать токен
- Сервису — у которого есть оферта и понятно, кто за ним стоит. Вставляйте токен только в настройки сервиса, не в форму на постороннем сайте и не в переписку с «менеджером».
- Своему разработчику — отдельный токен с минимумом категорий и, если можно, только на чтение.
- Сотруднику — не токен. Человеку нужен доступ пользователя в кабинете с ролью, а не ключ для программ.
- Никому в чате. Токен в мессенджере остаётся в истории, в резервных копиях и на чужих устройствах. Отправили — отзовите и создайте новый.
Прекращаете работу с сервисом — удалите его токен в тот же день. Раз в полгода просматривайте список: токенов, чьё назначение вы не помните, там быть не должно.
Токен не работает: частые причины
| Что видно | Причина | Что делать |
|---|---|---|
| Сервис перестал получать данные через полгода | Истёк срок — 180 дней | Создать новый токен и заменить |
| Не грузится один раздел: отчёты, реклама, отзывы | У токена нет нужной категории | Новый токен с этой категорией |
| Данные есть, но действия не выполняются | Токен «только чтение» | Новый токен с записью — если действия вам нужны |
| Перестали работать все токены сразу | Сменился владелец профиля или его телефон | Создать токены заново |
| Токен не принимается сразу после создания | Скопирован не полностью или вставлен токен другого типа | Сервисный работает только со своим сервисом, персональный — не с облачными |
| Данные приходят с задержкой | Лимиты ВБ на число запросов | Это не поломка: сервис повторит запрос позже |
Частые вопросы
Где найти токен на ВБ?
Создать — в профиле продавца, раздел «Интеграции по API», кнопка «+ Создать токен». Найти уже созданный токен нельзя: он показывается один раз, в момент создания. В разделе остаётся только его карточка — название, срок действия, уровень доступа и категории. Потеряли токен — создайте новый.
Сколько действует токен ВБ?
180 дней. За три дня до окончания срока владельцу профиля приходит уведомление на портале. После этого токен нужно создать заново и вставить новый во все сервисы, которые им пользовались.
Как проверить токен ВБ?
Откройте карточку токена в разделе «Интеграции по API»: там срок действия, уровень доступа и категории данных. Вставлять токен в сторонние сайты-«проверялки» не нужно: вы отдаёте ключ от кабинета неизвестно кому. Работает ли токен в конкретном сервисе, показывает сам сервис.
Можно ли изменить права уже созданного токена?
Нет. Категории данных и уровень доступа задаются при создании и потом не меняются. Чтобы добавить категорию или переключить «только чтение», создайте новый токен, вставьте его в сервис и удалите старый.
Какой токен создавать для стороннего сервиса?
Если сервис есть в каталоге решений WB — сервисный: категории подставятся сами, а токен будет работать только с этим сервисом. Если нет — базовый. Персональный токен предназначен для собственных программ на своей инфраструктуре; передавать его облачным сервисам WB запрещает.