Интерактивный обозреватель всего HTTP-API AiHummer на базе Scalar.
Здесь собраны все endpoints вашего инстанса: OpenAI-совместимый чат
(POST /v1/chat/completions), приём входящих сообщений и триггеры, привязка
устройств, SSO/SCIM и полное административное API — управление агентами,
знаниями, аналитикой, модулями и безопасностью.
Ключи выпускаются в веб-интерфейсе администратора. В Scalar нажмите
Authorize и вставьте ключ, чтобы выполнять пробные запросы (кнопка
«Try it out») прямо из браузера.
[!WARNING]
Административные методы могут менять данные вашего инстанса: пробный
запрос к ним выполняется по-настоящему, а не в песочнице. Выполняйте пробные
запросы к административным методам только на тестовом инстансе или осознанно.
Сервер
В спецификации указан плейсхолдер https://your-instance.example.com — выберите
в выпадающем списке серверов адрес вашего инстанса или замените его на свой
(в промышленной эксплуатации TLS терминируется на обратном прокси перед шлюзом).
[!TIP]
Спецификация в машинном виде доступна по адресу /openapi.json
и подходит для импорта в Postman, Insomnia или editor.swagger.io.
Интерактивный обозреватель всего HTTP-API AiHummer на базе **Scalar**.
Здесь собраны все endpoints вашего инстанса: OpenAI-совместимый чат
(`POST /v1/chat/completions`), приём входящих сообщений и триггеры, привязка
устройств, SSO/SCIM и полное административное API — управление агентами,
знаниями, аналитикой, модулями и безопасностью.
<p style="margin:1.5rem 0;">
<a href="/api/" style="display:inline-block;padding:0.85rem 1.5rem;border-radius:10px;background:#F0632E;color:#1a0d08;font-weight:600;text-decoration:none;">
Открыть Scalar →
</a>
</p>
## Аутентификация
Запросы авторизуются ключом API AiHummer (с префиксом `ah-`), который
передаётся как Bearer-токен:
```http
Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```
Ключи выпускаются в веб-интерфейсе администратора. В Scalar нажмите
**Authorize** и вставьте ключ, чтобы выполнять пробные запросы (кнопка
«Try it out») прямо из браузера.
> [!WARNING]
> Административные методы могут **менять данные** вашего инстанса: пробный
> запрос к ним выполняется по-настоящему, а не в песочнице. Выполняйте пробные
> запросы к административным методам только на тестовом инстансе или осознанно.
## Сервер
В спецификации указан плейсхолдер `https://your-instance.example.com` — выберите
в выпадающем списке серверов адрес вашего инстанса или замените его на свой
(в промышленной эксплуатации TLS терминируется на обратном прокси перед шлюзом).
> [!TIP]
> Спецификация в машинном виде доступна по адресу [`/openapi.json`](/openapi.json)
> и подходит для импорта в Postman, Insomnia или editor.swagger.io.
## Что дальше
- Подробно про чат-endpoint: [API Chat Completions](/v1.0/api/chat-completions).
- Входящие сообщения и триггеры: [Входящие и триггеры](/v1.0/api/inbound-triggers).
- Привязка устройств, SSO и протоколы: [Вебхуки, SCIM и привязка устройств](/v1.0/api/webhooks-scim-pairing).
