Как получить API ключ Ozon — пошаговая инструкция
Пошаговая инструкция по получению API ключа Ozon Seller: как создать ключ, какие роли выбрать, частые ошибки и подключение к Отзывоматик.
Что такое API ключ Ozon Seller и зачем он нужен
API ключ Ozon Seller — это уникальный идентификатор, который позволяет внешним сервисам взаимодействовать с вашим аккаунтом на маркетплейсе. С помощью API вы можете автоматизировать рутинные операции: управление товарами, обработку заказов, работу с отзывами и аналитику продаж.
Для подключения сервиса автоответов на отзывы, например Отзывоматик, вам понадобятся два параметра: Client ID и API Key. Client ID — это числовой идентификатор вашего аккаунта продавца, а API Key — секретный токен для авторизации запросов. Вместе они дают сервису доступ к чтению отзывов и отправке ответов от вашего имени.
Пошаговая инструкция: как получить API ключ Ozon
Шаг 1: Войдите в личный кабинет Ozon Seller
Откройте сайт seller.ozon.ru и авторизуйтесь с помощью логина и пароля вашего продавца. Если у вас несколько магазинов, выберите нужный аккаунт.
Шаг 2: Перейдите в раздел настроек API
В левом меню найдите раздел «Настройки» (значок шестерёнки). Внутри выберите подраздел «API-ключи» или «Seller API». Здесь вы увидите список уже созданных ключей (если они есть) и кнопку для создания нового.
Шаг 3: Создайте новый API ключ
Нажмите кнопку «Сгенерировать ключ» или «Создать ключ». Ozon предложит вам выбрать роли (разрешения) для этого ключа. Для работы с отзывами через Отзывоматик выберите следующие роли:
- Отзывы — чтение (для получения списка отзывов)
- Отзывы — запись (для отправки ответов на отзывы)
- Товары — чтение (для отображения названий товаров в интерфейсе)
Не выбирайте лишние роли — это принцип минимальных привилегий, который обеспечивает безопасность вашего аккаунта.
Шаг 4: Скопируйте Client ID и API Key
После генерации ключа Ozon покажет вам Client ID (числовой, например: 123456) и API Key (длинная строка символов). Важно: API Key показывается только один раз! Скопируйте и сохраните его в надёжное место. Если вы потеряете ключ, придётся создавать новый.
Client ID обычно отображается в верхней части страницы настроек — это номер вашего аккаунта продавца.
Шаг 5: Подключите ключ к Отзывоматик
Войдите в личный кабинет Отзывоматик, перейдите в «Настройки». В разделе Ozon вставьте Client ID и API Key в соответствующие поля и нажмите «Сохранить». Система проверит соединение и начнёт синхронизацию отзывов.
Какие роли (разрешения) нужны для API ключа
Ozon предлагает десятки различных ролей для API-ключей. Вот полный список ролей, которые могут быть полезны для работы с отзывами:
- Отзывы (Reviews) — обязательно. Чтение позволяет получать отзывы, запись — отправлять ответы.
- Товары (Products) — рекомендуется. Чтение позволяет видеть названия и фото товаров рядом с отзывами.
- Аналитика (Analytics) — опционально. Позволяет получать статистику по продажам для анализа влияния отзывов.
Не рекомендуется выдавать роли на управление ценами, заказами или финансами, если вы подключаете ключ только для работы с отзывами.
Частые ошибки при получении API ключа Ozon
Вот с какими проблемами чаще всего сталкиваются продавцы:
- «Доступ запрещён» при запросе отзывов — вы не выбрали роль «Отзывы — чтение» при создании ключа. Создайте новый ключ с правильными ролями.
- «Неверный API ключ» — убедитесь, что вы скопировали ключ без лишних пробелов в начале или конце строки. Проверьте, что используете именно API Key, а не Client ID.
- Ключ не работает через несколько дней — Ozon может деактивировать ключ при подозрительной активности или если вы превысили лимиты запросов. Проверьте статус ключа в настройках.
- Не могу найти раздел API в настройках — убедитесь, что ваш аккаунт имеет статус активного продавца. Для новых аккаунтов раздел API может быть недоступен до первой отгрузки товара.
- Несколько магазинов на одном аккаунте — каждый магазин имеет свой Client ID. Убедитесь, что создаёте ключ для нужного магазина.
Безопасность API ключа
API ключ — это по сути пароль к вашему магазину. Соблюдайте базовые правила безопасности:
- Никогда не передавайте API ключ по незащищённым каналам (публичные чаты, электронная почта без шифрования).
- Не публикуйте ключ в открытом доступе (GitHub, форумы, скриншоты).
- Используйте отдельный ключ для каждого сервиса — если один скомпрометирован, вы деактивируете только его.
- Периодически обновляйте ключи (раз в 3–6 месяцев).
Отзывоматик хранит ваши API ключи в зашифрованном виде (AES-256) и никогда не передаёт их третьим лицам.
Лимиты API Ozon Seller
Ozon устанавливает ограничения на количество запросов к API. Текущие лимиты для работы с отзывами:
- До 100 запросов в минуту для чтения отзывов
- До 50 запросов в минуту для отправки ответов
- Максимум 1000 отзывов за один запрос списка
Отзывоматик автоматически распределяет запросы в рамках лимитов, поэтому вам не нужно беспокоиться о блокировке ключа.
Попробуйте Отзывоматик бесплатно — подключите API ключ Ozon за 5 минут и автоматизируйте ответы на отзывы. Всего 299 ₽/мес за все маркетплейсы. Зарегистрироваться