Авторизация

Чтобы авторизоваться в API, вам понадобится токен. Он действует 180 дней после создания. Добавляйте токен в заголовок запроса Authorization.

По пункту 9.7.6 оферты запрещена интеграция с порталом продавца без публичного (этого) API.

Как создать токен

1. В личном кабинете нажмите на имя профиля и выберите Настройки → Доступ к API.
2. Если нужно, выберите опцию:
   • Тестовый контур: с токеном можно работать только в тестовом контуре (песочнице).
   • Только на чтение: с токеном нельзя ничего изменять, только получать данные. Работает для реальных данных и в тестовом контуре.

3. Выберите, с какими категориями API вы будете работать с этим токеном.

   Выбирайте только те категории, с которыми вы планируете работать. Например, если вы будете только загружать карточки товаров, выберите одну категорию — Контент. Если токен попадёт в чужие руки, по нему нельзя будет получить доступ к другим категориям API вашего магазина.

4. Нажмите Создать токен.

5. Скопируйте и сохраните токен в безопасном месте. Потом его нельзя будет посмотреть в личном кабинете. Если вы потеряли токен, создайте новый.

   Если у вас несколько сервисов (интеграций) для работы с разными категориями, создайте для них отдельные токены. Это позволит предоставить доступ только к необходимым категориям, а также более гибко и безопасно управлять интеграциями.

Как устроен токен

Токен представляет собой JWT согласно RFC 7519. Чтобы проверить, действителен ли ваш токен и какие категории методов API по нему доступны, вы можете декодировать его.

⚠️ Рекомендуем не просматривать токен с помощью онлайн-инструментов, чтобы он не попал в чужие руки.

Публичные поля токена

Поля, которых нет в таблице, служебные, и могут быть удалены.

Поле s

Поле s — это битовая маска, то есть целое число, каждый бит которого означает наличие или отсутствие какого-то свойства.

Подробнее про битовую маску

Значения бит

Позиция бита отсчитывается от 0, где 0 — это младший бит.