API-ключи

API-ключи предоставляют программный доступ к API Наговори без необходимости OAuth2-потоков.

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

Через панель управления

Перейдите в Профиль
Прокрутите до раздела API-ключи
Введите описательное имя и нажмите Создать ключ
Скопируйте ключ сразу — он больше не будет отображён

Через API

curl -X POST https://api.nagovori.ru/v1/api-keys \
  -H "Authorization: Bearer ВАШ_JWT_ИЛИ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production Server" }'

Ответ:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Production Server",
  "prefix": "nag_a1b2",
  "key": "nag_a1b2c3d4e5f67890abcdef1234567890",
  "scopes": [],
  "created_at": "2026-04-20T10:00:00Z"
}

Список ключей

curl https://api.nagovori.ru/v1/api-keys \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Ответ:

{
  "keys": [
    {
      "id": "...",
      "name": "Production Server",
      "prefix": "nag_a1b2",
      "scopes": [],
      "last_used_at": "2026-04-19T15:30:00Z",
      "created_at": "2026-04-10T10:00:00Z"
    }
  ]
}

Отзыв ключа

curl -X DELETE https://api.nagovori.ru/v1/api-keys/KEY_ID \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Отозван��ые ключи немедленно аннулируются и не подлежат восстановлению. При необходимости создайте новый ключ.

Формат ключа

Все API-ключи имеют формат:

nag_[32 шестнадцатеричных символа]

Пример: nag_a1b2c3d4e5f67890abcdef1234567890

Префикс nag_ позволяет легко идентифицировать ключи Наговори в коде и обнаруживать случайную утечку.