API (Swagger)

Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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