Тестовый токен и Песочница WB API
Когда нужен тестовый токен, как его создать и перейти к реальной работе
Дата обновления: 03.04.2026
Что такое тестовый токен
Тестовый токен — это специальный токен WB API, который предоставляет доступ только к тестовым данным, а не к реальной информации вашего магазина.
Тестовый токен работает в изолированной «учебной» среде (песочнице), где можно безопасно проверять интеграцию, не рискуя испортить реальные данные магазина.
Ключевое отличие от других токенов
| Тестовый токен | Сервисный / Персональный / Базовый | |
|---|---|---|
| Доступ к реальным данным | Нет | Да |
| Работает с настоящими товарами и заказами | Нет | Да |
| Среда | Песочница (тестовые данные) | Боевая (реальные данные) |
| Назначение | Разработка и тестирование | Реальная работа интеграций |
Для чего нужен тестовый токен
Для разработчиков интеграций. Разработчик может писать и отлаживать код без риска изменить цены, создать дубли карточек или испортить данные заказов.
Для изучения возможностей API. Можно экспериментировать с методами, изучать структуру данных, понимать возможности платформы.
Для проверки обновлений. Если планируется обновление работающей интеграции, можно протестировать новые функции до запуска.
Когда тестовый токен НЕ нужен
- Подключаете готовый сервис из Каталога решений для бизнеса на Wildberries → используйте Сервисный токен
- Подключаете собственную программу для реальной работы → используйте Персональный токен
- Хотите протестировать на реальных данных → используйте Базовый токен
Типичные ситуации: какой токен выбрать
Подключение сервиса аналитики из Каталога решений
Нужен: Сервисный токен. Сервису нужны реальные данные для анализа.
Разработчик начал создавать интеграцию
На этапе разработки: Тестовый токен — безопасно тестировать код. После завершения: Персональный токен — для работы с реальными данными.
IT-специалист изучает API
Нужен: Тестовый токен — можно экспериментировать без риска.
Подключение 1С
Нужен: Персональный токен (если 1С локальная) или Сервисный (если облачная из Каталога решений). Тестовый не подходит — он не работает с реальными данными.
Как создать тестовый токен
Создать тестовый токен может только владелец личного кабинета WB Партнёры.
- Зайдите в личный кабинет WB Партнёры
- Нажмите на название организации → «Интеграции по API»
- Нажмите «+ Создать токен»
- Перейдите на вкладку «Для интеграции вручную»
- Выберите «Тестовый токен»
- Добавьте комментарий (опционально), например: «Для разработчика Иванова»
- Нажмите «Создать»
- Нажмите «Скопировать и закрыть» — сохраните токен в надёжном месте
Особенности тестового токена
- Срок действия: 180 дней
- Доступ: Автоматически ко всем категориям песочницы
- Режим: Всегда чтение и запись
- Использование: Только для тестовой среды
Токен показывается только один раз при создании. Если потеряете — создайте новый.
Что такое песочница
Песочница (sandbox) — изолированная тестовая среда с искусственными данными, полностью отделённая от вашего магазина. Тестовый токен работает только с песочницей.
Подробнее о песочнице, доступных категориях и отличиях от боевой среды — в статье «Как работает песочница WB API». Конкретные ограничения по каждой категории, тестовые домены и нюансы — в статье «Ограничения тестового контура WB API».
Переход от тестирования к реальной работе
Шаг 1. Создайте рабочий токен
В зависимости от ситуации: Сервисный, Персональный или Базовый. Если не уверены — воспользуйтесь статьёй «Облачный сервис или локальное решение».
Шаг 2. Замените токен в коде
Разработчик заменяет тестовый токен на рабочий и тестовые домены (*-sandbox) на боевые.
Шаг 3. Проведите пилотное тестирование
Проверьте несколько товаров или заказов, убедитесь, что всё работает.
Шаг 4. Запустите интеграцию
После успешной проверки — полный запуск.
Шаг 5. Решите судьбу тестового токена
Если разработка завершена — можно удалить. Если планируются обновления — сохраните.
Чек-лист перед запуском
- ✓ Разработчик заменил тестовый токен на рабочий
- ✓ Тестовые домены заменены на боевые
- ✓ Интеграция проверена на нескольких реальных примерах
- ✓ Учтены ограничения тестового контура (лимиты, асинхронность, объём данных)
- ✓ Настроена обработка ошибок авторизации (401, 403)
- ✓ Есть план действий на случай проблем