Public API v1

Авторизация и права

API использует Bearer-токены с ограниченными правами и списком проектов. Cookie-сессия для внешнего клиента не нужна.

Bearer-токен

Передавайте секрет только в HTTP-заголовке. Не добавляйте его в URL, query string, JSON, логи или промпт агента.

Обязательные заголовкиhttp

Authorization: Bearer seo_pat_<secret>
Accept: application/json

Заголовки команд

Заголовок	Когда нужен	Назначение
`Authorization`	Всегда	Аутентификация API-ключа
`Content-Type: application/json`	Есть JSON body	Формат тела запроса
`Idempotency-Key`	Создание или запуск	Безопасный повтор одной команды
`If-Match: "v4"`	Изменение versioned ресурса	Защита от потерянного обновления
`X-Request-Id`	Необязательно	Собственный идентификатор трассировки

Scopes

Итоговый доступ — пересечение текущих прав пользователя, scopes ключа и allowlist проектов. Отзыв членства или архивация проекта действуют сразу, без перевыпуска ключа.

Проектыprojects:readprojects:write

Семантикаsemantics:readsemantics:write

Позицииpositions:readpositions:run

Частотностьfrequency:readfrequency:run

ИИ-ответыai:readai:run

Подбор ключейresearch:readresearch:run

Аудитыaudits:readaudits:run

Страницыpages:readpages:write

Заметкиnotes:readnotes:write

Интеграцииintegrations:readintegrations:write

Расписанияautomations:readautomations:manage