Любая автоматизация работы с маркетплейсами — перенос карточек, синхронизация цен и остатков, репрайсер — начинается с API-ключей. Разбираем, как выпустить ключи Ozon Seller и Wildberries, какие права им выдать и что делать, если ключ скомпрометирован.
API-ключ Ozon Seller
Ключ создаётся в личном кабинете продавца Ozon: раздел «Настройки» → «API ключи» (интерфейс периодически обновляется, ищите пункт про API в настройках). При создании вы получаете два значения:
- Client-Id — идентификатор ключа, не секретный сам по себе;
- Api-Key — собственно секретный ключ, который Ozon показывает один раз при создании. Сохраните его сразу: потом посмотреть будет нельзя, только перевыпустить.
При создании выбирается роль (тип) ключа: например, «Администратор» (Admin, полный доступ, включая аналитику), «Отчёты» (Report — доступ к аналитике и отчётам) и более узкие роли. Принцип безопасности — выдавать минимально необходимые права. Для переноса карточек и синхронизации цен и остатков обычно нужны права на товары и цены; аналитика доступна с ролями «Отчёты» или «Администратор».
API-токен Wildberries
У Wildberries токены создаются в кабинете продавца в разделе «Настройки» → «Доступ к API». Логика похожая, но есть свои особенности:
- Токен создаётся с выбором категорий доступа: «Контент» (карточки товаров), «Цены и скидки», «Статистика», «Аналитика», «Маркетплейс», «Поставки» и другие. Набор категорий меняется — ориентируйтесь на актуальный список в кабинете.
- Токен, как и ключ Ozon, показывается один раз — сохраните сразу.
- Для разных задач разумно делать разные токены: один — на контент и цены для переноса и синхронизации, другой — на статистику для аналитики.
Важно: у WB исторически были «старые» и «новые» форматы ключей и периодические миграции между версиями API. Если интеграция внезапно перестала работать — первым делом проверьте, не устарел ли формат токена и не изменился ли endpoint.
Какие права нужны для типовых задач
- Перенос карточек (фото, характеристики, описание): Ozon — роль на товары; WB — категория «Контент».
- Синхронизация цен: Ozon — роль на цены (или товары с ценами); WB — «Цены и скидки».
- Синхронизация остатков: Ozon — права на остатки/FBS; WB — соответствующая категория складов и остатков.
- Аналитика продаж: отдельные аналитические роли/категории на обеих площадках — не смешивайте их с ключом, которым меняете цены.
| Задача | Ozon Seller | Wildberries |
|---|---|---|
| Перенос карточек (фото, характеристики, описание) | Роль «Товары» | Категория «Контент» |
| Синхронизация цен | Роль на цены или товары с ценами | «Цены и скидки» |
| Синхронизация остатков | Права на остатки / FBS | Категория складов и остатков |
| Аналитика продаж | Роль «Отчёты» (Report) или «Администратор» | «Статистика» / «Аналитика» |
Безопасность и жизненный цикл ключей
- Храните ключи в менеджере секретов или хотя бы в защищённом хранилище, а не в открытом Excel на общем диске и не в переписке.
- Один сервис — один ключ. Не используйте один и тот же ключ в пяти интеграциях: при компрометации не поймёте, откуда утёк, и отзыв ключа сломает всё сразу.
- Перевыпускайте при подозрении на утечку. На обеих площадках старый ключ можно отозвать, создав новый. Сделайте это, если сотрудник с доступом к ключу уволился или сервис, которому вы его давали, вызывает сомнения.
- Следите за сроками. Маркетплейсы могут деактивировать ключи, которые долго не использовались, или требовать перевыпуска при смене политик. Если API начал отвечать 401 — проверьте ключ в кабинете.
- Не вшивайте ключи в код. Только переменные окружения или защищённое хранилище. Ключ, попавший в git-репозиторий, считается скомпрометированным.
Главное правило: один сервис — один ключ с минимально необходимыми правами. При любых сомнениях ключ проще перевыпустить за пару минут, чем потом разбираться с последствиями утечки.
Проверка ключей после выпуска
После создания ключа сделайте тестовый запрос: для Ozon — получение списка категорий или товаров, для WB — список карточек. Успешный ответ подтверждает, что и ключ рабочий, и прав хватает. Ошибка 401 означает неверный ключ, 403 — ключ валиден, но прав не хватает.
Кстати, в recards.ru при подключении Ozon и WB ключи валидируются автоматически: сервис сразу проверяет доступ и сообщает, если прав не хватает или ключ недействителен.
Итог
API-ключи — это «паспорт» вашей автоматизации. Выпустите отдельные ключи под каждую задачу, выдайте минимально необходимые права, сохраните их в безопасном месте и заведите привычку перевыпускать ключи при любых сомнениях. Пять минут на правильную настройку сейчас сэкономят часы разборок потом.