> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botmux.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API-ключи

> Программный доступ с аутентификацией по Bearer-токену

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

## Формат

Ключи используют префикс `bmx_`: `bmx_a1b2c3d4e5f6...`

## Использование

```bash theme={null}
curl -H "Authorization: Bearer bmx_your_key_here" \
  http://localhost:8080/api/bots
```

## Управление

Только для администраторов через веб-интерфейс или API:

| Метод | Эндпоинт                     | Описание               |
| ----- | ---------------------------- | ---------------------- |
| GET   | `/api/auth/api-keys`         | Список всех API-ключей |
| POST  | `/api/auth/api-keys/create`  | Создать новый ключ     |
| POST  | `/api/auth/api-keys/disable` | Отключить ключ         |
| POST  | `/api/auth/api-keys/delete`  | Удалить ключ           |

## Безопасность

* Ключи привязаны к пользователям и наследуют их роль и разрешения
* Хранятся в базе данных в виде хеша SHA-256
* Фактический ключ показывается только один раз при создании