Все 15 областей доступа для API-ключей и подключений AI: что разрешает каждая, как она называется в панели управления и что не может ни один API-ключ.
Области доступа (scopes) определяют, что может делать API-ключ. Те же 15 областей действуют и для AI-ассистентов, которых вы подключаете через MCP. Всегда выбирайте только те области, которые действительно нужны приложению.
Основные правила
- Каждый эндпоинт требует ровно одну область доступа
- Для API-ключей write:X автоматически включает read:X — в панели управления есть подсказка «write:X автоматически включает read:X»
- Если области доступа не хватает, API отвечает 403 insufficient_scope и называет нужную область в details.required_scope
- Эндпоинты, которые для API-ключей вообще не открыты, тоже отвечают 403 insufficient_scope
- Функции владельца и админа, например участники, оплата или управление доменами, недоступны ни с какой областью доступа
Все области доступа
В диалоге «Новый API-ключ» вы выбираете для каждой области «Чтение» или «Запись»; в списке ключей показаны названия областей из первого столбца. Форма вида «Чтение · Страницы» используется на странице согласия для AI-приложений и в разделе «Подключённые приложения».
| Область доступа | Для AI-приложений | Что разрешает |
|---|---|---|
| read:pages | Чтение · Страницы | Список и чтение страниц, чтение и проверка черновика, список блоков, чтение SEO, список версий, получение типов блоков |
| write:pages | Запись · Страницы | Создание и редактирование страниц (включая хэндл), редактирование черновика, создание, редактирование, удаление и сортировка блоков, редактирование SEO, видимость, публикация, восстановление версии, ссылки-приглашения для приватных страниц |
| read:links | Чтение · Ссылки | Список и чтение ссылок страницы |
| write:links | Запись · Ссылки | Создание, редактирование, удаление и сортировка ссылок |
| read:assets | Чтение · Файлы | Список файлов |
| write:assets | Запись · Файлы | Загрузка и удаление файлов, загрузки для страницы |
| read:forms | Чтение · Формы | Чтение форм, сводка, список заявок и их экспорт в CSV (экспорт начиная с Creator Pro) |
| write:forms | Запись · Формы | Создание, редактирование и удаление форм |
| read:stats | Чтение · Статистика | Статистика страниц и рабочего пространства (сводка, временные ряды, сравнение, ссылки, виджеты, конверсии, топ страниц), история push и расход push |
| read:workspaces | Чтение · Рабочие пространства | Чтение возможностей тарифа, использования, списка участников и настроек рабочего пространства, список доменов, список и чтение шаблонов, список и чтение секретов колбэков (без секрета в открытом виде) |
| write:workspaces | Запись · Рабочие пространства | Пока нет эндпоинтов сверх read:workspaces |
| read:donations | Чтение · Платежи от поддержавших | Суммы платежей от поддержавших в рабочем пространстве (платежи через блок «Поддержать») |
| read:short_links | Чтение · Короткие ссылки | Список и чтение коротких ссылок |
| write:short_links | Запись · Короткие ссылки | Создание, редактирование и удаление коротких ссылок |
| write:templates | Запись · Шаблоны рабочего пространства | Создание, редактирование и удаление собственных шаблонов рабочего пространства (читаются они с read:workspaces), см. Собственные шаблоны |
Какие именно эндпоинты относятся к какой области доступа, показано в статье Эндпоинты по разделам.
Что не может ни один API-ключ
- Удалять страницы
- Создавать ссылки предпросмотра для черновика
- Получать разбивку статистики по устройствам, странам, источникам перехода и UTM
- Отправлять push-уведомления и управлять правилами push
- Подключать и отключать интеграции
- Управлять вебхуками
- Добавлять, подтверждать, активировать, деактивировать и удалять домены
- Управлять участниками, приглашениями и ролями, передавать владение
- Менять настройки рабочего пространства, оплату
- Создавать, редактировать, перевыпускать и удалять секреты колбэков
- Получать список платежей от поддержавших, запросы на доступ к данным и анонимизировать заявки из форм
- Управлять профилем, вашими подписками и самими API-ключами
Всё это вы делаете в панели управления.
Области доступа для AI-ассистентов
Для MCP-подключения вы выбираете те же области доступа на странице согласия. Есть два отличия: во-первых, право на запись там не включает право на чтение — поэтому выдавайте оба. Во-вторых, выбор ограничен вашей ролью: наблюдатели получают только права на чтение (без форм и коротких ссылок), редакторы — всё, кроме «Запись · Рабочие пространства», коротких ссылок и шаблонов рабочего пространства. Подробнее — в статье Права, безопасность и лимиты.
Рекомендуемые комбинации
| Задача | Области доступа |
|---|---|
| Отчёты и дашборды | read:stats, read:pages |
| Синхронизация ссылок из CMS или магазина | write:links, read:pages |
| Автоматическое ведение и публикация страниц | write:pages, write:links |
| Ссылки для кампаний из CRM | write:short_links |
| Передача лидов из форм в CRM | read:forms |
| Выкатка шаблонов из CI-пайплайна | write:templates, read:workspaces |
Вам также может пригодиться
Ничего не нашли?
Напишите, что вам нужно, и наша служба поддержки поможет вам лично.