API (Swagger)

Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Бүкіл AiHummer HTTP API-і үшін интерактивті **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> ## Аутентификация Сұраулар Bearer токені ретінде жіберілетін AiHummer API кілтімен (`ah-` префиксті) аутентификацияланады: ```http Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` Кілттер веб админ 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](/kk/v1.0/api/chat-completions). - Кіріс хабарламалар мен триггерлер: [Кіріс және триггерлер](/kk/v1.0/api/inbound-triggers). - Жұптау, SSO және хаттамалар: [Webhook-тар, SCIM және жұптау](/kk/v1.0/api/webhooks-scim-pairing).