Как подключить программу к кабинету Яндекс Маркета по API
Учёт, автовыдачу или аналитику подключают к кабинету Маркета по API-ключу. Прежний способ, OAuth-токен, Маркет называет устаревшим и не рекомендует. Ключ создаётся за минуту, а от выбранных доступов зависит, что сможет программа. Ниже шаги с экранами кабинета и таблица доступов под частые задачи. Для автовыдачи цифровых товаров рекомендуем DBS.MARKET.
Что такое API-ключ
Это токен, по которому программа работает с вашим кабинетом через API Маркета. В кабинете его так и называют, «токен». Программа передаёт его в заголовке Api-Key.
Ключ работает для всех магазинов кабинета. Срок у него не ограничен, если не выключать «Бессрочный токен». Доступ к API бесплатный.
Для сравнения: OAuth-токен привязан к пользователю, который его создал, видит только его магазины и действует год.
Как создать ключ
- Нажмите на значок аккаунта справа вверху и откройте «Настройки».
- Слева выберите «API и модули». В блоке «Токены авторизации» нажмите «Создать новый токен».
- Введите название. По нему потом будет понятно, для чего ключ, поэтому удобно назвать его по программе.
- Выберите доступы, о них ниже. Переключатель «Бессрочный токен» оставьте включённым. Если его выключить, появится поле «Действует до» с датой через год.
- Нажмите «Создать» и скопируйте полученный ключ.
Создать ключ могут владелец и менеджер кабинета. Всего ключей в кабинете может быть до 30. Изменить или удалить ключ можно через три точки рядом с ним, изменения вступают в силу в течение 10 минут.
Какие доступы выбрать
В окне три варианта. «Полное управление кабинетом» разрешает программе любые запросы. «Просмотр всех данных» даёт только чтение, менять программа ничего не сможет. В варианте «Только выбранные» группы доступов отмечают по одной.
Ниже частые задачи и доступы, которых для них хватит. Данные взяты со страниц методов в документации Маркета.
Если у ключа нет прав на запрос, Маркет вернёт ошибку 403.
Маркет советует заводить для каждой программы отдельный ключ. Ключи лучше держать в хранилище секретов и не пересылать в переписке. Ненужные ключи удаляют, а при смене подрядчика меняют.
Где взять Campaign ID и Business ID
Многие программы просят ещё и номера. Оба есть в разделе «API и модули», в блоке «Интеграции магазинов»: Campaign ID у каждого магазина и Business ID всего кабинета. Campaign ID — это номер магазина для API. Маркет просит не путать его с номером магазина в кабинете и с рекламными кампаниями.
Что подключить вместе с ключом
Без уведомлений программа узнаёт о новом заказе, только когда сама опрашивает Маркет. А код активации цифрового товара нужно передать в течение 30 минут после того, как заказ перешёл в обработку. Поэтому вместе с ключом подключают API-уведомления, и тогда Маркет сам присылает запрос, когда появляется заказ или меняется его статус.
Подключают их там же: «API и модули» → вкладка «API-уведомления» → «Подключить уведомления». Адрес для уведомлений даёт программа. Маркет проверяет его, отправляя запрос PING.
Какой API-ключ нужен DBS.MARKET
Для автовыдачи ключей, подписок и других цифровых товаров рекомендуем DBS.MARKET. Сервис передаёт покупателю товар через минуту после оплаты, обновляет остатки и собирает в одной панели чаты, отзывы и аналитику. Для подключения создайте API-ключ с полным управлением кабинетом: так сервис сразу получит доступ к заказам, остаткам, чатам, отзывам и отчётам.
Источники: документация Partner API Маркета (разделы «Авторизация», «Создание и использование API-Key-токена», «Доступы», «Типы ошибок и что с ними делать», «Лучшие практики интеграции с API Яндекс Маркета для продавцов», страницы методов), кабинет продавца. Проверено 10 октября 2026.