AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Webhooklar, SCIM va juftlash

Webhooklar, SCIM va juftlash

v1.0.x · yangilandi 2026-06-26

Ushbu sahifa qolgan protokol yuzalarini qamrab oladi: qurilma juftlash, korxona autentifikatsiya federatsiyasi (SAML / SCIM / OAuth), ixtiyoriy MCP server va A2A endpoint’lari, media uzatish, va Connect-RPC xizmatlari. Bularning bir nechtasi standart holatda oʻchiq va aniq yoqilishi kerak.

Qurilma juftlash

Mobil va ish stoli mijozlari instansiyaga qisqa juftlash almashinuvi orqali qoʻshiladi (iOS/macOS ilovasi faqat QR juftlashidan foydalanadi).

Metod va yoʻl Maqsad
POST /v1/pairing/redeem Juftlash kodini qaytarib oling va qurilmani taʼminlang
POST /v1/pairing/device/validate Allaqachon juftlangan qurilmani tasdiqlang 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Autentifikatsiya federatsiyasi

AiHummer ham login, ham foydalanuvchini taʼminlash uchun korxona identifikatsiya provayderlari bilan integratsiyalashadi.

SAML

Metod va yoʻl Maqsad
GET /saml/metadata IdP’ingiz uchun xizmat-provayder metadata’si
POST /saml/acs Assertion Consumer Service (SAML javobi)
GET /saml/login SAML login’ni boshlash

SCIM taʼminlash

System for Cross-domain Identity Management (SCIM 2.0) IdP’ingizga foydalanuvchilarni avtomatik yaratish va boshqarish imkonini beradi.

Metod va yoʻl Maqsad
.../scim/v2/Users Foydalanuvchilarni roʻyxatlash / yaratish
.../scim/v2/Users/{id} Foydalanuvchini oʻqish / yangilash / oʻchirish

OAuth token

Metod va yoʻl Maqsad
POST /v1/oauth/token OAuth token endpoint’i

MCP server (tashqariga nashr etish)

AiHummer MCP server sifatida amal qilib oʻz asboblarini MCP mijozlariga nashr eta oladi. Bu ixtiyoriy va siz AIHUMMER_MCP_PUBLISH=1 oʻrnatmaguningizcha oʻchiq.

Metod va yoʻl Maqsad
POST /v1/mcp MCP server endpoint’i (AIHUMMER_MCP_PUBLISH=1 talab qiladi)

[!NOTE] Asboblarni tashqariga nashr etish MCP serverni kodsiz integratsiya sifatida iste’mol qilishdan farq qiladi. Bu endpoint boshqa MCP mijozlariga AiHummer’ga chaqirish imkonini berish uchun.

A2A (Agent-to-Agent)

AiHummer boshqa agentlar uni topib, unga xabar yuborishi uchun A2A yuzasini taqdim eta oladi. Bu ham AIHUMMER_A2A_PUBLISH=1 orqali ixtiyoriy.

Metod va yoʻl Maqsad
GET /.well-known/agent.json A2A agent kartasi / aniqlash hujjati
POST /a2a/message A2A xabarini qabul qilish (AIHUMMER_A2A_PUBLISH=1 talab qiladi)

Media

Katta media (audio, rasmlar, fayllar) JSON tanalariga joylashtirilgandan koʻra maxsus endpoint’lar orqali yuklanadi va olinadi.

Metod va yoʻl Maqsad
PUT /v1/media/{id}/content Media obyekti uchun baytlarni yuklash
GET /v1/files/{id} Saqlangan faylni yuklab olish

[!TIP] Media/fayl xizmatini yoqish uchun AIHUMMER_BLOB_DIR’ni oʻrnating, va imzolangan yuklab olish URL’lari qayta ishga tushirishlar boʻylab amal qilib qolishi uchun AIHUMMER_MEDIA_TOKEN_SECRET’ni oʻrnating.

Connect-RPC xizmatlari

Tiplangan, oqimli mijozlar uchun AiHummer HTTP ustida Connect-RPC xizmatlarini ham taqdim etadi (server-oqimi qoʻllab-quvvatlanadi):

Xizmat Soha
aihummer.health.v1 Salomatlik tekshiruvlari
aihummer.event.v1 Hodisalar oqimi
aihummer.conversation.v1 Suhbatlar
aihummer.push.v1 Push yetkazish
aihummer.media.v1 Media uzatish
aihummer.turn.v1 Turn bajarish

Keyin qayerga