Про API-ключи простыми словами

Что такое API-токен

API-токен (ключ) — это длинная комбинация букв и цифр, которая служит «электронным пропуском» от вашего кабинета маркетплейса. Наш сервис с помощью этого пропуска видит ваши заказы, товары и остатки и выполняет за вас действия: печать этикеток, создание поставок, передачу в доставку.

Важно понимать:

• токен не даёт доступа к вашим деньгам на маркетплейсе — только к данным и операциям, которые вы разрешили;
• токен можно в любой момент отозвать (удалить) в кабинете маркетплейса — и доступ пропадёт;
• мы храним токены в зашифрованном виде и используем только для работы вашего магазина.

Общие правила безопасности

1. Никому не пересылайте токен — ни в мессенджерах, ни по почте. Нашему сервису токен вводится только вами на странице «Подключения маркетплейсов».
2. Маркетплейс показывает токен один раз при создании. Если не успели скопировать — создайте новый.
3. Если подозреваете, что токен «утёк», — отзовите его в кабинете маркетплейса и подключите новый.
4. Заведите отдельный токен под наш сервис: так проще отследить, кто и что делает в кабинете, и при необходимости отозвать доступ без ущерба остальным интеграциям.

Несколько токенов на один магазин

К одному магазину можно подключить несколько ключей с разными правами — это удобно и безопаснее:

• один ключ — «для отгрузки» (права на изменение заказов и поставок);
• второй — «только чтение» (товары, документы, аналитика).

Добавляется второй ключ просто: в разделе «Подключения маркетплейсов» найдите нужный магазин и в блоке «API-токены» заполните строку «Новый токен» — при желании укажите комментарий, например «для отгрузки». У каждого токена есть кнопки «Проверить» (проверить, работает ли), «Откл./Вкл.» и «Удалить».

Если токен перестал работать

Причины обычно две:

1. Истёк срок действия. У Ozon ключи живут 180 дней, у других маркетплейсов тоже появляются ограничения. Решение: создайте новый ключ в кабинете маркетплейса и добавьте его в «Подключениях» (старый удалите).
2. Ключ отозван или не хватает прав. Проверьте, что ключ активен и при создании были отмечены нужные разрешения (какие именно — в статьях о подключении конкретного маркетплейса).

Признак неработающего токена — красные точки в строке «синхр.:» у магазина и ошибки при синхронизации. Обновите ключ — данные снова начнут подтягиваться.