Создание и использование API-Key-токена

Чтобы работать с Маркетом по API:

  1. Создайте токен с доступами к определенным группам методов. Так сотрудники смогут выполнять только те методы, которые нужны им для работы. Какие бывают доступы
  2. Вставьте токен в заголовки запросов к Маркету.

Создавать токены и управлять ими может только владелец кабинета и менеджер кабинета. Подробнее о том, какие бывают роли, читайте в Справке Маркета для продавцов.

Создать токен

  1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу Модули и API.

  2. В блоке Авторизационный токен нажмите кнопку Создать или Создать новый токен, если вы уже получали его.

    Скриншот

  3. В открывшемся окне:

    1. Укажите уникальное название токена.

    2. Выберите доступы для этого токена — один или несколько.

    3. Нажмите кнопку Создать.

    Скриншот

Редактировать токен

Перед редактированием

Убедитесь, что ваша интеграция продолжит работать с измененным токеном.

Вы можете изменить доступы, а также название токена. Для этого:

  1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу Модули и API.

  2. В блоке Авторизационные токены найдите нужный, нажмите три точки рядом с ним и выберите Редактировать.

  3. Измените необходимую информацию.

  4. Нажмите Сохранить.

Информация обновится в течение 10 минут.

Удалить токен

Перед удалением

Убедитесь, что без этого токена ваша интеграция продолжит работать.

  1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу Модули и API.

  2. В блоке Авторизационные токены найдите нужный, нажмите три точки рядом с ним и выберите Удалить.

  3. Подтвердите удаление.

Передать токен

Полученный токен вставьте в заголовок Api-Key по следующей схеме:

Api-Key: <token>

В результате заголовок будет выглядеть так:

Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664

Если запрос придет без заголовка с действительным токеном, Маркет вернет ошибку 401 Unauthorized.

Может быть полезно