API (Swagger)

Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

ინტერაქტიული **Swagger UI** მკვლევარი მთელი AiHummer HTTP API-სთვის. თქვენი ინსტანციის ყველა endpoint აქ არის: OpenAI-თან თავსებადი chat ზედაპირი (`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 სრულდება gateway-ის წინ მდგომ reverse proxy-ზე). > [!TIP] > მანქანისთვის წასაკითხი სპეციფიკაცია ხელმისაწვდომია [`/openapi.json`](/openapi.json)-ზე და > სუფთად იმპორტირდება Postman-ში, Insomnia-ში ან editor.swagger.io-ში. ## სად შემდეგ - chat endpoint დეტალურად: [Chat Completions API](/ka/v1.0/api/chat-completions). - შემომავალი შეტყობინებები და ტრიგერები: [შემომავალი და ტრიგერები](/ka/v1.0/api/inbound-triggers). - დაწყვილება, SSO და პროტოკოლები: [Webhooks, SCIM და დაწყვილება](/ka/v1.0/api/webhooks-scim-pairing).