API-ключ маркетплейса: как подключить аналитику и не раскрыть доступы

1. 1В личном кабинете откройте «Настройки» → «API-ключи».
2. 2Нажмите «Создать API-ключ».
3. 3Укажите название ключа, чтобы потом не путаться.
4. 4Выберите права доступа: для аналитики достаточно «Чтение отчётов» и «Информация о заказах».
5. 5После создания ключ отобразится в списке. Скопируйте его.

Яндекс Маркет

1. 1Войдите в кабинет продавца.
2. 2Перейдите в «Настройки» → «API».
3. 3Нажмите «Получить токен».
4. 4Подтвердите действие через SMS или код из приложения.
5. 5Токен появится в поле — скопируйте его и храните в безопасном месте.

Какие права доступа давать

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

Что должно быть включено:

• информация о заказах и продажах;
• остатки на складах;
• отчёты (финансовые, по реализации);
• данные о возвратах.

Что должно быть отключено:

• управление ценами и скидками;
• редактирование карточек товаров;
• управление рекламными кампаниями;
• доступ к личным данным покупателей.

Если маркетплейс позволяет создавать несколько ключей с разными правами, сделайте отдельный ключ для каждого сервиса. Так вы сможете отозвать доступ к одному сервису, не затронув другие.

Как передать ключ в сервис аналитики

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

В сервисах с ручным вводом:

• найдите в настройках сервиса раздел «Подключение маркетплейсов» или «API-ключи»;
• вставьте скопированную строку в соответствующее поле;
• выберите маркетплейс и, если нужно, укажите название магазина;
• сохраните настройки.

В сервисах с автоматическим импортом (например, Sellviz):

• перейдите в раздел Интеграции;
• выберите маркетплейс;
• вставьте ключ в поле ввода;
• нажмите «Подключить».

После подключения сервис начнёт загружать данные. Первая синхронизация может занять от нескольких минут до часа в зависимости от объёма.

Как проверить, что ключ работает

Даже если вы скопировали ключ правильно, стоит убедиться, что сервис получил доступ к данным.

1. 1Откройте дашборд сервиса аналитики.
2. 2Проверьте, отображаются ли заказы за последние 24 часа.
3. 3Сравните цифры с личным кабинетом маркетплейса — они должны совпадать.
4. 4Если данные не подгружаются, проверьте:

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

Когда и как отозвать ключ

Ключ нужно отозвать, если:

• вы перестали пользоваться сервисом аналитики;
• ключ мог попасть к посторонним;
• вы подозреваете утечку данных.

На Wildberries: раздел «Настройки» → «Доступ к API» → кнопка «Удалить» напротив ключа.

На Ozon: «Настройки» → «API-ключи» → значок корзины рядом с ключом.

На Яндекс Маркете: «Настройки» → «API» → «Отозвать токен».

После отзыва сервис потеряет доступ к данным. Если вы планируете вернуться к сервису, придётся создавать новый ключ.

Что делать, если ключ уже скомпрометирован

Если вы случайно отправили ключ в чат поддержки, опубликовали в открытом доступе или передали непроверенному сервису:

1. 1Немедленно отзовите ключ в личном кабинете маркетплейса.
2. 2Создайте новый ключ с ограниченными правами.
3. 3Проверьте, не было ли подозрительной активности: изменения цен, заказы от вашего имени, необычные запросы к API.
4. 4Если активность была, обратитесь в поддержку маркетплейса.

Как хранить ключи безопасно

• Не храните ключи в открытом виде на рабочем столе или в мессенджерах.
• Используйте менеджеры паролей (Bitwarden, 1Password, KeePass).
• Не передавайте ключи через email или соцсети.
• Если работаете с командой, дайте доступ к ключу только тем сотрудникам, кому он действительно нужен.
• Регулярно пересоздавайте ключи — раз в 3–6 месяцев.