Как работает песочница WB API
Тестовая среда с искусственными данными — без риска для магазина
Дата обновления: 03.04.2026
Что такое песочница
Песочница (sandbox) — это изолированная тестовая среда WB API с искусственными данными. Она полностью отделена от реальных данных вашего магазина: что бы вы ни делали в песочнице, это никак не затронет ваши товары, заказы, цены или другую информацию на Wildberries.
Песочница предназначена для разработки и тестирования интеграций. Она позволяет писать и отлаживать код, экспериментировать с методами API, проверять обработку ошибок — всё это без риска испортить реальные данные.
Что можно тестировать
В песочнице доступны основные категории API для тестирования:
- Создание и редактирование карточек товаров
- Изменение цен и скидок
- Обработка заказов
- Управление поставками
- Работа с рекламными кампаниями
- Ответы на отзывы и вопросы
- Получение статистики и отчётов
Методы в песочнице работают на отдельных доменах. Например, для категории «Контент» боевой домен — content-api.wildberries.ru, а тестовый — content-api-sandbox.wildberries.ru. Адреса тестовых доменов указаны в документации для каждой категории.
Чем песочница отличается от боевой среды
| Параметр | Песочница | Боевая среда |
|---|---|---|
| Данные | Искусственные, сгенерированные | Реальные данные вашего магазина |
| Токен | Тестовый токен | Персональный, Сервисный или Базовый |
| Домен | *-sandbox.wildberries.ru | *-api.wildberries.ru |
| Влияние на магазин | Нет | Да — все изменения применяются |
| Лимиты запросов | Действуют (строже, чем в основном API) | Действуют |
В песочнице стандартный лимит — 1 запрос в секунду для большинства категорий. Полный список доступных категорий, тестовых доменов и ограничений — в статье «Ограничения тестового контура WB API».
Не все категории API имеют тестовый домен. Проверяйте наличие песочницы для конкретной категории в документации или в статье «Ограничения тестового контура».
Как начать работу
-
Создайте тестовый токен в разделе «Интеграции по API» личного кабинета WB Партнёры. Тестовый токен автоматически получает доступ ко всем категориям песочницы с правами на чтение и запись.
-
Используйте тестовые домены при отправке запросов. Замените боевой домен на тестовый — остальная часть URL (путь, параметры) остаётся такой же.
-
Работайте с тестовыми данными. Песочница содержит сгенерированные данные — не ожидайте увидеть реальные товары или заказы вашего магазина.
Подробнее о тестовом токене, его особенностях и создании — в статье «Тестовый токен и Песочница WB API».
Если при тестировании возникают ошибки авторизации — проверьте, что используете тестовый токен с тестовым доменом. Разбор ошибок — в статье «Ошибки авторизации WB API и их решение».
Как перейти от тестирования к реальной работе
Когда интеграция протестирована в песочнице, нужно создать рабочий токен, заменить тестовые домены на боевые и провести пилотную проверку на реальных данных. Пошаговый план перехода с чек-листом — в статье «Тестовый токен и Песочница WB API». О технических нюансах, которые нужно учесть при переходе (различия в лимитах, асинхронная обработка, объём данных) — в статье «Ограничения тестового контура WB API».