Чтобы sellerdata или любой другой сервис мог читать данные вашего магазина на Яндекс Маркете, ему нужен ключ API — на Маркете он называется токеном авторизации. Разберём, что это такое, где его создать, какие доступы выбрать и почему токен только на просмотр безопасен для магазина.
Коротко. Токен создаётся в кабинете Маркета: «Настройки» → «API и модули» → «Токены авторизации». Для аналитики достаточно четырёх прав только на просмотр — с ними сервис видит данные, но ничего не может изменить.
Что такое ключ API Яндекс Маркета
API — это способ, которым программы обмениваются данными без участия человека. Через API Маркета сервисы получают заказы, товары, цены и финансовые отчёты вашего магазина. Токен — это длинная строка символов, по которой Маркет понимает, что запрос пришёл от вас и какие данные можно отдавать.
У современного токена Маркета (его называют Api-Key) есть три особенности, которые важно знать (документация Маркета):
- токен привязан к кабинету, а не к человеку, и открывает доступ ко всем магазинам этого кабинета;
- для токена можно выбрать отдельные группы доступов — например, только просмотр;
- срок действия не ограничен: токен работает, пока вы его не удалите.
Прежний способ — OAuth-токен — Маркет считает устаревшим и рекомендует переходить на Api-Key.
Где создать токен
Создавать токены и управлять ими может только владелец кабинета или менеджер кабинета. В одном кабинете можно завести до 30 токенов (документация Маркета).
- В кабинете продавца нажмите на профиль в правом верхнем углу и выберите «Настройки».
- Откройте раздел «API и модули».
- В блоке «Токены авторизации» нажмите «Создать новый токен».
- Укажите название, выберите доступы и нажмите «Создать».
Подробная инструкция для sellerdata со скриншотами каждого шага — в статье «Как подключить Яндекс Маркет к sellerdata».
Какие доступы бывают
При создании токена Маркет предлагает три варианта: «Полное управление кабинетом», «Просмотр всех данных» или «Только выбранные». В последнем случае вы сами отмечаете группы прав (полный список). Почти для каждой группы есть пара: право на управление и право только на просмотр.
| Право только на просмотр | Право на управление |
|---|---|
| Просмотр информации о заказах | Обработка заказов и учёт товаров |
| Просмотр цен | Управление ценами |
| Просмотр товаров и карточек | Управление товарами и карточками |
| Просмотр информации о продвижении товаров | Продвижение товаров |
| Просмотр финансовой информации и отчётности | — |
| Получение информации по FBY-заявкам | — |
| — | Общение с покупателями |
| — | Настройка магазинов |
Правило простое: сервису аналитики нужны только права на просмотр. Если сервис просит «Полное управление» или права на изменение цен и товаров, а сам цены не меняет, — это лишний риск.
Какие доступы нужны sellerdata
sellerdata просит четыре права, и все они только на просмотр:
- «Просмотр информации о заказах» — заказы, продажи, возвраты.
- «Просмотр товаров и карточек» — список товаров и артикулы.
- «Просмотр финансовой информации и отчётности» — удержания Маркета и выплаты.
- «Просмотр цен» — цены товаров.
После подключения эти права видны в sellerdata: «Настройки» → «Общие», зелёные отметки «Заказы», «Товары», «Цены», «Финансы» у магазина Маркета.
Почему токен только на просмотр безопасен
С правами на просмотр сервис технически не может изменить цены, остатки, карточки или статусы заказов — Маркет просто не выполнит такой запрос. Деньги и реквизиты через эти права тоже недоступны. Вы в любой момент можете отредактировать или удалить токен: «Настройки» → «API и модули», три точки рядом с токеном. После удаления сервис перестанет получать данные. Как sellerdata защищает данные — на странице «Безопасность данных».
Частые ошибки с токеном
- Скопирован не весь токен. Строка длинная, и при копировании легко потерять символы в начале или конце.
- Выбраны не все нужные права. Сервис подключится, но часть данных — например, финансовые отчёты — не загрузится.
- Токен удалён или отредактирован в кабинете. Изменения прав Маркет применяет в течение 10 минут, после удаления доступ пропадает.
- Токен создал сотрудник без нужной роли. Создавать токены может только владелец или менеджер кабинета.
Частые вопросы
Ключ API и токен Яндекс Маркета — это одно и то же?
Да. В кабинете Маркета это называется токеном авторизации, в сервисах аналитики — ключом API. В sellerdata токен вставляется в поле «API-ключ Yandex Market».
Нужен ли отдельный токен для каждого магазина?
Нет. Токен Api-Key привязан к кабинету и открывает все магазины в нём. Если в кабинете несколько бизнесов, sellerdata при подключении предложит выбрать нужный.
Сколько действует токен?
Бессрочно — пока вы его не удалите. При создании включите «Бессрочный токен».
Можно ли использовать один токен в нескольких сервисах?
Технически да, но надёжнее создать отдельный токен для каждого сервиса: так вы сможете отключить один сервис, не затрагивая остальные. В кабинете можно завести до 30 токенов.
Что будет, если удалить токен?
Сервис перестанет получать новые данные. Чтобы возобновить загрузку, создайте новый токен и замените ключ в sellerdata: «Настройки» → «Общие» → «Изменить ключ».
Может ли sellerdata изменить что-то в магазине?
Нет. Все четыре права — только на просмотр.
Всё о работе с Маркетом в sellerdata — на странице «Аналитика Яндекс Маркета». Подключить магазин — по пошаговой инструкции.
