API-ключи
Выпуск, scope, ротация и отзыв API-ключей.
API-ключи аутентифицируют REST- и MCP-вызовы вне веб-приложений Solved — скрипты, бэкенды, AI-агенты.
Создание. Ключ привязан к аккаунту, а не к продукту, и выпускается из настроек аккаунта
(account.solved.group, когда появится кабинет; до этого — со страницы API-ключей в настройках любого
продукта, в который вы вошли). Выпуск требует сессию не старше 10 минут — если она старше, система
попросит войти заново (step_up_required) перед выдачей ключа.
Ключ выглядит так: slv_live_e17Hk2Qp…9xZr4fT2aB. Он показывается полностью один раз, в момент
создания, — сохраните его сразу, потому что сервер хранит только соленый хэш. Если ключ потерян,
восстановить его нельзя — только выпустить roll.
Scope. Каждый ключ выпускается с одним или несколькими scope, например link:links.write,
artqr:qr.read, либо link:* на весь продукт. Выдавайте минимальный scope под задачу — write нужен,
только если ключ создаёт или меняет данные.
Использование.
Ротация без простоя: POST /v1/api-keys/{key_id}/roll выпускает новый ключ и оставляет старый
рабочим на выбранный grace-период (до 7 дней) — успеете перевыпустить деплой, пока старый ключ ещё
действует.
Отзыв — мгновенно из настроек аккаунта или вызовом отзыва; распространяется на все сервисы за 30 секунд. Если есть подозрение на утечку, используйте «Защитить аккаунт» вместо обычного отзыва — это действие отзывает сразу все ключи и все гранты OAuth на аккаунте.
Далее: Quickstart REST · Quickstart MCP · Аутентификация и scope