Создание и использование API-Key-токена
Чтобы работать с Маркетом через API:
- Создайте токен с доступами к определенным группам методов. Так сотрудники смогут вызывать только те методы, которые нужны им для работы. Какие бывают доступы
- Вставьте токен в заголовок запроса к Маркету.
Создавать токены и управлять ими может только владелец кабинета и менеджер кабинета. Подробнее о том, какие бывают роли, читайте в Справке Маркета для продавцов.
Максимальное количество токенов для кабинета — 30.
Создать токен
-
В кабинете продавца на Маркете нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули.
-
В блоке Токены авторизации нажмите кнопку Создать новый токен.
-
В открывшемся окне:
-
Укажите уникальное название токена.
-
Выберите доступы, которые нужно предоставить.
-
Нажмите кнопку Создать.
-
Редактировать токен
Перед редактированием
Убедитесь, что ваша интеграция продолжит работать с измененным токеном.
Вы можете изменить доступы, а также название токена. Для этого:
-
В кабинете продавца на Маркете нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули.
-
В блоке Токены авторизации найдите нужный, нажмите три точки рядом с ним и выберите Редактировать.
-
Измените необходимую информацию.
-
Нажмите Сохранить.
Информация обновится в течение 10 минут.
Удалить токен
Перед удалением
Убедитесь, что без этого токена ваша интеграция продолжит работать.
-
В кабинете продавца на Маркете нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули.
-
В блоке Токены авторизации найдите нужный, нажмите три точки рядом с ним и выберите Удалить.
-
Подтвердите удаление.
Передать токен
Полученный токен вставьте в заголовок Api-Key по следующей схеме:
Api-Key: <token>
В результате заголовок будет выглядеть так:
Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664
Если запрос придет без заголовка с действительным токеном, Маркет вернет ошибку 401 Unauthorized.