Как найти и получить API ключ Ozon: подробная инструкция с нюансами

Работа с API Ozon открывает продавцам возможности для автоматизации бизнес-процессов: от синхронизации остатков товаров до управления заказами через внешние системы типа 1С, MoySklad или Bitrix24. Однако первый шаг — получение API ключа — часто вызывает вопросы. Где его искать в личном кабинете? Какие права нужны для генерации? И почему ключ может внезапно перестать работать?

В этой статье мы разберём все актуальные способы получения API ключа в 2026 году, включая скрытые нюансы для новых и опытных продавцов. Вы узнаете, как создать ключ с нужными разрешениями, где его хранить, и что делать, если доступ заблокирован. А ещё — как избежать типичных ошибок, из-за которых интеграция срывается на этапе аутентификации.

Что такое API ключ Ozon и зачем он нужен

API ключ — это уникальный идентификатор доступа, который позволяет внешним системам взаимодействовать с платформой Ozon от имени вашего аккаунта. Без него невозможно:

🔄 Автоматически обновлять цены и остатки товаров в 1С или МойСклад.
📦 Получать данные о новых заказах в CRM-систему (например, Bitrix24 или АмоCRM).
📊 Выгружать отчёты по продажам в аналитические сервисы типа Google Sheets или Power BI.
🤖 Настраивать чат-ботов для обработки вопросов покупателей (через Telegram, ВКонтакте).

Важно понимать, что API ключ — это не просто «пароль». Он привязан к конкретным разрешениям (скопам), которые вы указываете при создании. Например, один ключ может разрешать только чтение заказов, а другой — ещё и их редактирование. Это защищает ваш аккаунт от несанкционированных действий, если ключ попадет в чужие руки.

📊 Для чего вы планируете использовать API Ozon?

Автоматизация заказов

Синхронизация с 1С

Аналитика продаж

Чат-боты для клиентов

Другое

Где в личном кабинете Ozon находится раздел с API ключами

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

🔹 Способ 1. Через новую версию ЛК (2026 год)

Авторизуйтесь на сайте seller.ozon.ru.
В верхнем меню кликните на иконку шестерёнки (⚙ Настройки).
В выпадающем списке выберите пункт API и Интеграции.
Перейдите на вкладку Ключи API.

🔹 Способ 2. Через старую версию ЛК (если новая не доступна)

Зайдите в личный кабинет и в адресной строке браузера добавьте в конце URL: /api-keys (полный путь будет выглядеть как https://seller.ozon.ru/app/api-keys).
Если страница не открывается, вернитесь в Настройки → Интеграции → API.

Если раздела API и Интеграции нет в меню, это может означать:

❌ У вашей учётной записи недостаточно прав (например, вы не владелец магазина).
❌ Аккаунт находится в статусе «На модерации» или заблокирован.
❌ Вы используете мобильную версию сайта (API ключи доступны только в десктопной версии).

Пошаговая инструкция: как создать API ключ в Ozon

Когда вы оказались в разделе Ключи API, следуйте этой инструкции, чтобы сгенерировать новый ключ:

Нажмите кнопку «Создать ключ» (обычно расположена в правом верхнем углу).
Задайте название ключа. Используйте осмысленное имя, чтобы позже было понятно, для чего он предназначен. Примеры:
- 📌 1С: Синхронизация остатков
- 📌 Bitrix24: Заказы (только чтение)
- 📌 Тестовый ключ для разработчика
Выберите срок действия ключа:
- 🔹 Без ограничения — ключ будет действовать до ручной отмены.
- 🔹 Ограниченный срок — укажите дату и время истечения (рекомендуется для тестовых ключей).

Настройте разрешения (скопы). Это самый важный этап! Отмечайте только те права, которые действительно необходимы. Например:

📦 Заказы: чтение — для получения информации о заказах.
💰 Финансы: чтение — для выгрузки отчётов по выплатам.
📝 Товары: чтение и запись — для обновления цен и остатков.

⚠️ Внимание: Не выдавайте ключу права Управление аккаунтом или Удаление товаров, если в этом нет острой необходимости. Это повышает риск несанкционированных действий при утечке ключа.

Подтвердите создание ключа через SMS или email (зависит от настроек безопасности аккаунта).
Скопируйте сгенерированный ключ и сохраните его в надёжном месте (например, в менеджере паролей). Ключ отображается только один раз — после закрытия окна восстановить его будет невозможно!

Выбран минимально необходимый набор разрешений|

Указано осмысленное название ключа|

Срок действия соответствует цели использования|

Ключ будет сохранён в защищённом месте|

-->

Какие разрешения (скопы) выбрать для API ключа

Ошибка в выборе разрешений — одна из главных причин, почему интеграция с Ozon не работает. Ниже приведена таблица с основными скопами и их назначением:

Категория разрешений	Конкретный скоп	Для чего нужен	Рекомендация
Заказы	`orders:read`	Получение списка заказов и их деталей	✅ Обязателен для CRM-интеграций
	`orders:acknowledge`	Подтверждение заказов (перевод в статус «В обработке»)	✅ Нужно для автоматической обработки
	`orders:cancel`	Отмена заказов	⚠️ Выдавать только при необходимости
Товары	`products:read`	Получение информации о товарах (цены, остатки, описания)	✅ Базовое разрешение для синхронизации
Товары	`products:write`	Редактирование товаров (цена, остаток, описание)	✅ Требуется для автоматического обновления цен
Финансы	`finance:read`	Получение данных о выплатах, комиссиях, штрафах	✅ Нужно для бухгалтерских систем
Финансы	`finance:write`	Изменение финансовых данных (например, списание средств)	❌Almost never needed

Если вы не уверены, какие разрешения нужны, начните с минимального набора:

📦 orders:read — для чтения заказов.
📝 products:read — для чтения информации о товарах.

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

Что будет, если выдать ключу лишние разрешения?

Лишние разрешения увеличивают риск злоупотреблений. Например, если ключ с правом products:write попадёт к конкуренту, он сможет изменить цены или остатки ваших товаров. А ключ с разрешением finance:write теоретически позволяет списывать средства с вашего баланса. Всегда следуйте принципу минимальных привилегий!

Где хранить API ключ Ozon: правила безопасности

API ключ — это как пароль от вашего банковского счёта, но с ещё более широкими возможностями. Его утечка может привести к:

💸 Финансовым потерям (изменение цен, отмена заказов).
📉 Репутационному ущербу (например, если кто-то отменит все ваши заказы).
🚫 Блокировке аккаунта (Ozon может заподозрить мошенничество).

Как правильно хранить ключ:

🔐 Менеджеры паролей: 1Password, KeePass, Bitwarden. Они шифруют данные и защищают мастер-паролем.
📄 Защищённые документы: если храните в файле, шифруйте его (например, через 7-Zip с паролем).
🚫 Чего делать нельзя:
- Отправлять ключ по email или мессенджерам.
- Хранить в открытом виде на облачных дисках (Google Drive, Яндекс.Диск).
- Вставлять ключ в публичные репозитории (GitHub, GitLab).

Если ключ скомпрометирован (например, его увидел посторонний человек), немедленно отзовите его в личном кабинете Ozon и сгенерируйте новый.

Что делать, если API ключ не работает или заблокирован

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

Срок действия ключа:
Зайдите в раздел API и Интеграции → Ключи API и проверьте, не истёк ли срок. Если да — создайте новый ключ.
Статус аккаунта:
Убедитесь, что ваш магазин не заблокирован или не находится на модерации. В таком случае все API ключи автоматически деактивируются.
IP-ограничения:
Ozon может блокировать запросы с подозрительных IP-адресов. Если вы подключаетесь через VPN или прокси, попробуйте отключить их.
Ошибки в запросах:
Проверьте, правильно ли указан ключ в настройках вашей CRM или другого сервиса. Частая ошибка — лишние пробелы в начале или конце ключа.
```
Пример правильного формата ключа:
Client-Id: 12345678-90ab-cdef-1234-567890abcdef
Api-Key: your_api_key_here_1234567890abcdef
```
Ограничения по количеству запросов:
Ozon устанавливает лимиты на количество API-запросов (обычно 1000 запросов в минуту). Если вы превысили лимит, ключ временно блокируется. Проверьте логи вашей системы на частые повторные запросы.

Если ключ заблокирован без видимой причины, обратитесь в поддержку Ozon через личный кабинет (Помощь → Написать в поддержку). В сообщении укажите:

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

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

Если ключ больше не нужен или вы подозреваете его утечку, обязательно отзовите его. Для этого:

Перейдите в Настройки → API и Интеграции → Ключи API.
Найдите в списке нужный ключ и нажмите на три точки (⋮) в конце строки.
Выберите Отозвать ключ.
Подтвердите действие (может потребоваться ввод SMS-кода).

После отзыва ключ нельзя восстановить — придётся создавать новый. Все интеграции, использовавшие этот ключ, перестанут работать, поэтому:

🔄 Заранее создайте замену ключу, если он используется в рабочих системах.
📋 Составьте список сервисов, где этот ключ был указан, чтобы обновить его везде.

⚠️ Внимание: Удалённые ключи могут оставаться активными в кэше некоторых сервисов до 24 часов. Если вы подозреваете взлом, помимо отзыва ключа смените пароль от личного кабинета Ozon и включите двухфакторную аутентификацию.

FAQ: Частые вопросы про API ключи Ozon

Можно ли использовать один API ключ для нескольких магазинов на Ozon?

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

Сколько API ключей можно создать в одном аккаунте?

Ozon не устанавливает жёсткого лимита на количество ключей, но создавать их «про запас» не рекомендуется. Оптимально — 1 ключ на каждую интеграцию (например, отдельно для 1С, отдельно для CRM).

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

Вы можете сделать тестовый запрос к API Ozon. Например, чтобы получить информацию о вашем аккаунте, отправьте GET-запрос на:

https://api-seller.ozon.ru/v1/analytics/data
Headers:
Client-Id: [ваш_client_id]
Api-Key: [ваш_api_key]

Если ключ рабочий, сервер вернёт ответ с кодом 200 и данными. Если нет — вы получите ошибку 401 Unauthorized.

Что делать, если в личном кабинете нет раздела «API и Интеграции»?

Это может означать:

У вашей учётной записи недостаточно прав (вы не владелец магазина). Обратитесь к администратору аккаунта.
Ваш магазин ещё не прошёл модерацию или заблокирован. Проверьте статус в разделе Профиль магазина.
Вы используете устаревшую версию личного кабинета. Попробуйте обновить страницу или очистить кэш браузера.

Можно ли восстановить удалённый API ключ?

Нет, удалённые или отозванные ключи восстановить нельзя. Придётся создавать новый. Именно поэтому важно хранить ключи в надёжном месте и не удалять их без необходимости.