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