Авторизация
Чтобы авторизоваться в API, вам понадобится токен. Он действует 180 дней после создания. Добавляйте токен в заголовок запроса Authorization
.
По пункту 9.7.6 оферты запрещена интеграция с порталом продавца без публичного (этого) API.
Как создать токен
- В личном кабинете нажмите на имя профиля и выберите Настройки → Доступ к API.
- Если нужно, выберите опцию:
- Тестовый контур: с токеном можно работать только в тестовом окружении (песочнице).
- Только на чтение: с токеном нельзя ничего изменять, только получать данные. Работает для реальных данных и в тестовом контуре.
Выберите, с какими категориями API вы будете работать с этим токеном.
Совет:
- Выбирайте только те категории, с которыми вы планируете работать. Например, если вы будете только загружать карточки товаров, выберите одну категорию — Контент. Если токен попадёт в чужие руки, по нему нельзя будет получить полный доступ к вашему магазину.
- Если у вас несколько сервисов (интеграций) для работы с разными категориями, создайте для них отдельные токены.
Нажмите Создать токен.
- Скопируйте и сохраните токен в безопасном месте. Потом его нельзя будет посмотреть в личном кабинете. Если вы потеряли токен, создайте новый.
Как устроен токен
Токен представляет собой JWT согласно RFC 7519.
⚠️ Рекомендуем не просматривать токен с помощью онлайн-инструментов, чтобы он не попал в чужие руки.
Публичные поля токена
Поля, которых нет в таблице, служебные, и могут быть удалены.
Поле | Тип | Описание |
---|---|---|
id |
UUIDv4 |
Уникальный идентификатор токена |
s |
uint |
Битовая маска свойств токена |
sid |
UUIDv4 |
Уникальный идентификатор продавца на Wildberries, которому принадлежит токен |
exp |
uint |
Время жизни токена. Соответствует стандарту RFC 7519: JSON Web Token (JWT) |
t |
boolean |
Тестовый контур (песочница) |
Поле s
Поле s
— это битовая маска, то есть целое число, каждый бит которого означает наличие или отсутствие какого-то свойства.
Значения бит
Позиция бита отсчитывается от 0, где 0 — это младший бит.
Позиция бита | Свойство (если бит равен 1) |
---|---|
1 | Доступ к категории Контент |
2 | Доступ к категории Аналитика |
3 | Доступ к категории Цены и скидки |
4 | Доступ к категории Маркетплейс |
5 | Доступ к категории Статистика |
6 | Доступ к категории Продвижение |
7 | Доступ к категории Вопросы и отзывы |
8 | Доступ к категории Рекомендации |
9 | Доступ к категории Чат с покупателями |
30 | Токен только на чтение |