Как получить API-ключ Ozon Seller и подключить сервисы аналитики без риска
Где в кабинете создаётся ключ Seller API, какие права ему давать, как подключать сторонние сервисы безопасно, чем Seller API отличается от Performance API, и как понять, что интеграция работает.
API-ключ — это способ дать программе доступ к вашему кабинету без передачи логина и пароля. Сервисы аналитики, репрайсеры, учётные системы, сервисы расчёта прибыли — все они работают через ключ. Создать его — две минуты. Создать правильно, чтобы сервис получил только то, что нужно, а вы могли отозвать доступ в любой момент, — чуть дольше. Здесь — пошагово и с правилами, которые мы вывели, подключив несколько интеграций и один раз пожалев.
Что такое ключ и Client ID
Доступ к Seller API состоит из двух частей. Client ID — номер вашего магазина, один и тот же для всех ключей, не секрет. API-ключ — длинная строка, которую вы создаёте в кабинете; это секрет, по нему программа действует от вашего имени. Сервису нужны оба.
Ключей может быть много. Правильно — по одному на каждый сервис, с названием этого сервиса и только теми правами, которые ему нужны. Тогда отзыв одного ключа не ломает остальные интеграции.
Как создать ключ
- Войдите в кабинет Ozon Seller.
- «Настройки» → «API-ключи» (может называться «Интеграции»).
- Скопируйте Client ID вверху страницы — он понадобится сервису.
- Нажмите «Сгенерировать ключ» или «Создать ключ».
- Введите название — по имени сервиса: «Аналитика X», «Учёт МойСклад», «Starbox».
- Выберите тип или права доступа. Если есть выбор «полный / только чтение / по разделам» — берите минимально необходимое.
- Сохраните. Ключ покажут один раз — скопируйте сразу. После закрытия окна увидеть его повторно нельзя, только создать новый.
- Вставьте Client ID и ключ в настройках сервиса. Обычно сервис сразу проверяет подключение.
Если магазинов несколько — у каждого свой Client ID и свои ключи. Переключитесь в нужный перед созданием.
Какие права давать
Ozon позволяет ограничивать ключи по назначению. Логика простая: сервису аналитики — чтение (товары, заказы, финансы, аналитика); репрайсеру — чтение плюс изменение цен; учётной системе — чтение заказов и изменение остатков; сервису расчёта прибыли — чтение. Полный доступ («администратор») — никому из внешних. Он позволяет менять всё, включая то, что сервису не нужно, и ошибка сервиса становится вашей проблемой.
| Сервис | Что ему нужно | Что не нужно |
|---|---|---|
| Аналитика ниш и конкурентов | Чтение аналитики и товаров | Цены, остатки, заказы на запись |
| Расчёт прибыли, контроль рекламы | Чтение товаров, заказов, финансов, аналитики | Любая запись |
| Репрайсер | Чтение + изменение цен | Остатки, заказы |
| Учётная система | Чтение заказов + изменение остатков | Цены (если не нужно) |
| Печать этикеток | Чтение заказов, формирование этикеток | Всё остальное |
| Управление рекламой | Performance API — отдельные ключи | Seller API вообще |
Seller API и Performance API — разные вещи
Seller API — товары, заказы, остатки, цены, финансы, аналитика продаж. Performance API — рекламные кампании: создание, ставки, статистика, бюджеты. У них разные кабинеты, разные идентификаторы (Performance Client ID выглядит как почта с доменом advertising) и разные ключи. Сервис, который «управляет рекламой», попросит Performance-ключи; сервис прибыли — Seller-ключи; сервис, который делает и то и другое, — оба.
Performance-ключи создаются в рекламном кабинете, в разделе настроек API. Логика та же: отдельный ключ на сервис.
Как проверить, что интеграция работает
После подключения нормальный сервис показывает статус: «подключено», дата последней синхронизации, количество загруженных товаров или заказов. Если данных нет через час — проверьте: ключ скопирован полностью, Client ID от того же магазина, права ключа покрывают то, что сервис запрашивает. Ошибка «403» или «нет доступа» — не хватает прав. «401» — ключ неверный или отозван. Лимиты запросов Ozon тоже существуют: если сервис сделал слишком много запросов, часть данных придёт позже — это не ошибка.
Безопасность: правила, которые мы вывели
Никогда не отправлять ключ в открытом чате, на почту без необходимости, в скриншотах. Ключ — как пароль. Раз в квартал открывать список ключей и отзывать те, которые больше не используются: у нас в первый год накопилось семь ключей, из которых работали три. Не давать ключи «ботам из телеграма» и «бесплатным сервисам без сайта»: ключ с правом записи — это возможность обнулить остатки или сменить цены. При подозрении на утечку — отозвать и создать новый; Client ID менять не нужно.
Однажды мы выдали ключ с полным доступом сервису, который затем изменил цены по своей логике «оптимизации» на десяти карточках. Заметили через день. С тех пор запись цен — только у одного ключа, и мы знаем, у какого.
Лимиты и особенности Seller API, о которых стоит знать
Даже если вы не пишете код сами, полезно понимать, почему сервис иногда «отстаёт». Ozon ограничивает количество запросов к API в единицу времени; при большом ассортименте полная синхронизация занимает время, а некоторые отчёты (например, аналитика остатков) отдаются с задержкой в часы. Финансовые данные закрываются по периодам — за текущий день детализация неполная. Поэтому цифры в сервисе, подключённом по API, могут отличаться от кабинета «прямо сейчас» и совпадать на утро.
Ещё одна особенность: часть методов API меняется, старые версии отключаются. Нормальные сервисы следят за этим сами; если интеграция вдруг перестала обновлять данные — часто причина именно в этом, и решается обновлением на стороне сервиса, а не пересозданием ключа.
Как подключить свой сервис, если вы сами разработчик
Документация Seller API открыта, у методов понятные названия: список товаров, остатки, цены, отправления, финансовые транзакции, аналитика. Для доступа нужны заголовки с Client ID и ключом. Начните с методов чтения, проверьте лимиты, потом переходите к записи. Тестируйте изменения цен и остатков на одном товаре, а не на всём каталоге — восстановить массово испорченные цены можно, но нервно.
Что можно автоматизировать в первую очередь
Если задача — понять, зачем вообще API, вот с чего начинают: расчёт прибыли по товарам (кабинет этого не делает, сервис по API — делает ежедневно); контроль остатков и напоминание о поставке; сводка по рекламе с ДРР по каждой кампании; синхронизация остатков с учётной системой при FBS; автоматическая печать этикеток. Всё это делается готовыми сервисами без программиста. Своя разработка имеет смысл, когда ассортимент большой и процессы нестандартные.
FAQ
Где взять API-ключ Ozon Seller?
В кабинете: «Настройки» → «API-ключи». Там же Client ID. Ключ показывается один раз при создании.
Сколько ключей можно создать?
Достаточно много для любых практических нужд. Рекомендуется отдельный ключ на каждый сервис.
Безопасно ли давать ключ стороннему сервису?
Да, если сервис известный, а ключ — с минимальными правами. Ключ можно отозвать в любой момент, и это не затрагивает другие интеграции.
Может ли сервис по ключу вывести деньги или изменить реквизиты?
Нет. Seller API не даёт доступа к реквизитам, выплатам и настройкам кабинета. Максимум с правами на запись — цены, остатки, карточки. Это тоже чувствительно, поэтому права выдаются по минимуму.
Что делать, если ключ потерян?
Посмотреть его повторно нельзя. Отзовите старый и создайте новый, обновите в настройках сервиса.
Видит ли Ozon, какие сервисы подключены к моему кабинету?
Площадка видит запросы по вашим ключам, но не «названия сервисов». Она не запрещает интеграции с внешними сервисами — при условии, что те не нарушают правила (например, не накручивают показатели).
Нужен ли API-ключ для приложения Ozon Seller или для входа сотрудника?
Нет. Приложение и сотрудники входят через Ozon ID и роли. API-ключи — только для программ и сервисов.
Вы развиваете магазин. ИИ разбирается с рутиной.
Поручите Starbox AI поиск потерь в прибыли, проверку рекламы и планирование запасов. Задавайте вопросы в чате и получайте рекомендации по своему магазину. Попробуйте ИИ-менеджера для Ozon 14 дней бесплатно, без карты.
Попробовать ИИ-менеджера бесплатно