Ключи и права доступа

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

Как выдать ключ

В разделе Токены → API-ключи нажмите Создать API-ключ, укажите назначение, срок действия и необходимость записи. Для выдачи нужно право управления токенами. По умолчанию ключ работает только на чтение. Срок: от одного дня до года.

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

Изменения доступа

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

В списке показаны название, начало ключа, срок, последнее использование и статус. Секрет не хранится открытым и повторно не показывается. Для замены создайте новый ключ, обновите интеграцию, затем отзовите старый. Отзыв необратим.

Границы внешнего API

Доступны рабочие ресурсы сбора и доставки данных. Недоступны AI-помощник, выдача новых ключей, управление пользователями и ролями, оплаты, развёртывание агентов, выдача агентских секретов и служебная синхронизация. Агенты доступны только для чтения.

Не отдавайте ключ браузеру посетителя вашего магазина. Выполняйте запросы с собственного сервера. Не записывайте заголовок Authorization в общедоступные логи.

Частота и стоимость

До 120 запросов в минуту на ключ. Отдельные тяжёлые операции имеют дополнительный общий предел. При 429 учитывайте Retry-After. Ограничение частоты API отличается от RPS сайта: RPS регулирует обращения парсера к источнику.

Создание и запуск ресурсов, обработка и скачивание расходуют обычные лимиты пространства. Ключ не создаёт отдельную бесплатную квоту. Подробности: лимиты.

Формат ID и безопасность

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