API-ключи Ozon Seller: как получить Client-Id и Api-Key
Любой сервис, который автоматизирует работу с Ozon — аналитика, биддеры, управление карточками, — попросит у вас два значения: Client-Id и Api-Key. Это «логин и пароль» вашего магазина для программ. В гайде: как их получить за пять минут, какие права выдавать, как не подставить свой магазин и что вообще умеет Seller API.
Что такое Seller API
Ozon Seller API — официальный программный доступ к вашему кабинету продавца. Всё, что вы делаете в кабинете руками, программы могут делать через API: заводить и редактировать карточки, менять цены и остатки, читать заказы и отчёты, отвечать на отзывы. Доступ бесплатный для всех продавцов.
Аутентификация — пара постоянных значений:
- Client-Id — номер вашего аккаунта продавца;
- Api-Key — секретный ключ, который вы генерируете сами.
Как получить ключи: по шагам
- Зайдите в кабинет Ozon Seller под аккаунтом владельца или менеджера с ролью «Администратор» — только у них есть права на управление API.
- В правом верхнем углу нажмите значок профиля и откройте Настройки → API ключи.
- Нажмите «Сгенерировать ключ».
- Укажите название ключа — по имени сервиса, для которого он создаётся (например, «Cardix»). Через полгода вы не вспомните, что такое «ключ 3», а по названиям сможете отзывать доступы точечно.
- Выберите тип токена. Ozon позволяет ограничить права ключа — например, дать доступ только к товарам. Правило: выдавайте минимум, который нужен сервису. Для работы с карточками достаточно прав на товары; доступ к финансовым отчётам таким сервисам не нужен.
- Скопируйте Api-Key сразу — после создания он хранится в скрытом виде и больше не показывается; восстановить его нельзя, только создать новый. Client-Id виден на той же странице.
Готово: пара Client-Id + Api-Key передаётся в сервис, который будет работать с вашим магазином.
Важно про срок действия. С 13 февраля 2026 года каждый новый ключ Seller API действует 6 месяцев (180 дней) с момента создания. По истечении срока запросы начинают возвращать ошибку авторизации — нужно сгенерировать новый ключ и обновить его в подключённых сервисах. Поставьте напоминание заранее, чтобы интеграции не встали в неожиданный момент.
Правила безопасности (коротко, но всерьёз)
- Один сервис — один ключ. Перестали пользоваться сервисом — отозвали его ключ, остальные продолжают работать.
- Не публикуйте ключи — ни в чатах, ни в скриншотах, ни в Google-таблицах с подрядчиками. Пара Client-Id + Api-Key даёт доступ к магазину без всякого пароля.
- Проверяйте, как сервис хранит ключи. Нормальный ответ: в зашифрованном виде, с доступом только у вашего аккаунта. Если сервис не может ответить — плохой знак. (В Cardix ключи шифруются AES-256 и не показываются повторно даже вам.)
- Заметили странную активность — отзовите ключ в том же разделе кабинета: интеграция встанет, магазин останется цел.
Что можно автоматизировать через Seller API
| Задача | Что даёт |
|---|---|
| Создание и обновление карточек | Массовый завод товаров без ручного ввода — карточка уходит через product/import и проходит модерацию как обычная |
| Цены и остатки | Синхронизация с учётной системой или репрайсером |
| Заказы и отгрузки | Интеграция со складом/фулфилментом |
| Отчёты | Выгрузка продаж и финансов в свою аналитику |
| Отзывы и вопросы | Мониторинг и ответы из одного окна (работа с отзывами по API доступна на расширенной подписке Ozon) |
Типовые ошибки при подключении
| Симптом | Причина | Решение |
|---|---|---|
| 401/403 при первом запросе | Опечатка в ключе, лишний пробел при копировании | Перекопировать; проверить, что ключ не отозван |
| Сервис видит не тот магазин | Несколько кабинетов — ключ от другого | Сверить Client-Id с нужным кабинетом |
| «Недостаточно прав» | Ключ создан с урезанным типом токена | Создать ключ с нужными правами |
| Всё работало и сломалось | Истёк срок ключа (6 месяцев) или его отозвали | Сгенерировать новый ключ; договориться, кто управляет разделом API |
Как это использует Cardix
Cardix публикует карточки на Ozon через официальный product/import: вы подключаете Client-Id + Api-Key один раз — дальше AI собирает данные о товаре, подбирает категорию и тип, заполняет обязательные атрибуты и отправляет карточку на модерацию Ozon прямо из кабинета Cardix. Ключи хранятся в зашифрованном виде — подробности в документации по публикации на Ozon.
Подключить Ozon к Cardix → Первые карточки — бесплатно, на стартовом бонусе.