Аутентификация

Аутентификация по API-ключу

API-ключи — рекомендуемый способ аутентификации программных запросов. Передавайте ваш ключ в заголовке запроса X-API-Key.

curl https://your-agentika-instance/api/v1/workflow/fetch \
  -H "X-API-Key: dg_your_api_key"

API-ключи привязаны к организации. Все ресурсы, созданные или полученные с помощью ключа, принадлежат этой организации.

Создание API-ключа

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

Для self-hosted развёртываний с локальной аутентификацией сначала зарегистрируйтесь и войдите через панель управления, затем создайте там API-ключ, прежде чем выполнять запросы к API.

Управление API-ключами

Действие	Метод	Путь
Список ключей	`GET`	`/user/api-keys`
Создать ключ	`POST`	`/user/api-keys`
Архивировать ключ	`DELETE`	`/user/api-keys/{api_key_id}`
Восстановить ключ	`PUT`	`/user/api-keys/{api_key_id}/reactivate`

Архивация ключа немедленно отзывает его. Все последующие запросы с этим ключом возвращают 401.

Ответы с ошибками

Статус	Причина
`401 Unauthorized`	Отсутствующие, недействительные или истёкшие учётные данные
`403 Forbidden`	Учётные данные действительны, но недостаточно прав для доступа к ресурсу

{
  "detail": "Invalid or expired API key"
}

Ресурсы