API (Swagger)

Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Интерактивный обозреватель всего HTTP-API AiHummer на базе **Swagger UI**. Здесь собраны все эндпоинты вашего инстанса: 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;"> Открыть Swagger UI → </a> </p> ## Аутентификация Запросы авторизуются ключом API AiHummer (с префиксом `ah-`), который передаётся как Bearer-токен: ```http Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` Ключи выпускаются в веб-интерфейсе администратора. В Swagger UI нажмите **Authorize** и вставьте ключ, чтобы выполнять пробные запросы («Try it out») прямо из браузера. ## Сервер В спецификации указан плейсхолдер `https://your-instance.example.com` — выберите в выпадающем списке серверов адрес вашего инстанса или замените его на свой (в продакшене TLS терминируется на обратном прокси перед шлюзом). > [!TIP] > Спецификация в машинном виде доступна по адресу [`/openapi.json`](/openapi.json) > и подходит для импорта в Postman, Insomnia или editor.swagger.io. ## Что дальше - Подробно про чат-эндпоинт: [API Chat Completions](/v1.0/api/chat-completions). - Входящие сообщения и триггеры: [Входящие и триггеры](/v1.0/api/inbound-triggers). - Привязка, SSO и протоколы: [Вебхуки, SCIM и привязка](/v1.0/api/webhooks-scim-pairing).