API (Swagger)

Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Интерактив **Swagger UI** аиссаалаҩ AiHummer HTTP API зегь разы. Шәара иинстанс зегьы ахьырргоу абра иҟоуп: 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;"> Open Swagger UI → </a> </p> ## Авторизациа Аҳәарақәа иавторизациатәуп AiHummer API калит ала (`ah-` префикс ацны) иршьҭуа Bearer-токенс: ```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](/en/v1.0/api/chat-completions). - Иҩнаауа ацҳамҭақәеи атриггерцәеи: [Иҩнаауа & триггерцәа](/en/v1.0/api/inbound-triggers). - Аиԥшьа, SSO насгьы апротоколқәа: [Вебхукқәа, SCIM & аиԥшьа](/en/v1.0/api/webhooks-scim-pairing).