API и приложения

Через публичный API MarketMate ваши системы и скрипты получают доступ к товарам Я.Маркета, Ozon и Wildberries: списку товаров с фильтрами, отдельному товару, истории его изменений. Через API можно также менять настройки товара. Каждый запрос выполняется с API-ключом, который выпускается в разделе Настройки → Инструменты → API и приложения.

ИИ-ассистенты Claude и ChatGPT подключаются без ключа — входом через MarketMate. Как это сделать, описано на странице «Подключение Claude и ChatGPT». Такие подключения показываются в этом же разделе вместе с ключами.

Описание всех методов, параметров, ошибок и лимитов открыто без входа: документация API (Swagger). Выполнить запрос со страницы документации можно только с ключом — нажмите Authorize и вставьте его значение.

Выпуск ключа

1. Откройте Настройки → Инструменты → API и приложения и нажмите Создать ключ.
2. Укажите название, по которому ключ будет легко узнать, например «Склад 1С» или «ИИ-ассистент».
3. Выберите уровень доступа: «Только чтение» или «Чтение и изменение».
4. Нажмите Создать и сохраните показанное значение ключа.

Значение ключа показывается один раз. Восстановить его нельзя: если ключ потерян, выпустите новый, а старый удалите.

Ключи выпускает владелец аккаунта или сотрудник, роли которого выдано право Дополнительно → API ключи → Создание API ключа. Сотрудник может выпустить до 5 ключей, на весь аккаунт — до 20. Подключения Claude и ChatGPT учитываются в этих же лимитах.

Ключи, выпущенные до запуска нынешней версии API, к ней не подключаются. Для работы с API выпустите новый ключ.

Уровни доступа

Уровень	Что разрешено
Только чтение	Получать список товаров, товар и историю его изменений
Чтение и изменение	То же, а также менять настройки товара

Если ИИ-ассистент или другая программа подключается по ключу, выдавайте ключ «Только чтение»: так ассистент ничего не изменит в ваших товарах.

Чьи права действуют

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

• для списка и отдельного товара нужно право Маркетплейсы → Товары → Список товаров;
• для истории — Маркетплейсы → Товары → История цен и остатков;
• для изменения настроек — Маркетплейсы → Товары → Обновление настроек товара и ключ «Чтение и изменение».

Если у сотрудника забрали право, его ключ сразу перестаёт получать соответствующие данные. Ключи удалённого или неактивного сотрудника не работают.

Просмотр и отзыв ключей

В разделе Настройки → Инструменты → API и приложения сотрудник видит свои ключи и подключения, а владелец аккаунта — ключи и подключения всех сотрудников. На карточке ключа указаны название, начало значения, уровень доступа, сотрудник, дата создания и время последнего использования. Подключения Claude и ChatGPT отмечены значком Приложение, начала значения у них нет; отключаются они кнопкой Отключить (см. «Подключение Claude и ChatGPT»).

Чтобы отозвать ключ, удалите его. Удалённый ключ перестаёт работать сразу, следующий запрос по нему будет отклонён.

Изменение настроек товара

Через API меняются те же настройки, что и в карточке товара в кабинете, с теми же ограничениями значений: ручная цена, добавочная наценка, ручная наценка и «Не передавать остатки». За один запрос можно изменить несколько настроек.

Изменение сразу сохраняется в MarketMate и появляется в истории товара с пометкой, каким ключом и каким сотрудником оно сделано. На маркетплейс изменение уходит при очередной синхронизации, так же как изменение из кабинета.

Лимиты запросов

У каждого метода свой лимит, общий для всех ключей аккаунта:

Метод	Лимит
Список товаров	60 запросов в минуту, до 10 подряд
Товар	180 запросов в минуту, до 20 подряд
История товара	60 запросов в минуту, до 10 подряд
Изменение настроек товара	60 запросов в минуту, до 10 подряд

Остаток допустимых запросов передаётся в заголовках каждого ответа. При превышении лимита API возвращает ошибку «слишком много запросов» (код 429) и время, через которое можно повторить запрос.

Безопасность

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

Ключи от маркетплейсов, которые вы указываете при подключении магазина, — это другие ключи, и к этому разделу они не относятся.

Если нужен доступ к другим данным, кроме товаров, напишите в поддержку: расскажите, какие данные и в какую систему нужно передавать.