AiHummer
Azərbaycanca▾
Daxil olŞəxsi kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Vebhooklar, SCIM və Cütləşdirmə

Vebhooklar, SCIM və Cütləşdirmə

v1.0.x · yeniləndi 2026-07-05

Bu səhifə qalan protokol səthlərini əhatə edir: cühaz qoşulması, müəssisə avtorizasiya federasiyası (SAML / SCIM / OAuth), seçmək imkanı MCP server və A2A son nöqtələr, media köçürmək və RPC-ə əlaqə xidmətlər. Bunların bir neçəsi standart olaraq söndürülüb və açıq şəkildə aktivləşdirilməlidir.

Cihazın qoşulması

Mobil və masaüstü müştərilər qısa cütləşmə mübadiləsi vasitəsilə bir nümunəyə qoşulurlar (iOS/macOS tətbiqi yalnız QR cütləşməsini istifadə edir).

Metod və yol Məqsəd
POST /v1/pairing/redeem Bir cütləşdirmə kodunu istifadə edin və cihazı təmin edin
POST /v1/pairing/device/validate Artıq qoşulmuş cihazı təsdiqləyin 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Avtorizasiya federasiyası

AiHummer həm giriş, həm də istifadəçi təminatı üçün müəssisə identlik təminatçıları ilə inteqrasiya olunur.

SAML

Metod və yol Məqsəd
GET /saml/metadata İdP-niz üçün xidmət təminatçısı metadatası
POST /saml/acs Tələb Tüketici Xidməti (SAML cavabı)
GET /saml/login SAML daxil olmasını başladın

SCIM təminatı

Çapraz domen İdentifikasiya İdarəetmə Sistemi (SCIM 2.0) IdP-nizin istifadəçiləri avtomatik yaratmasına və idarə etməsinə imkan verir.

Metod və yol Məqsəd
.../scim/v2/Users İstifadəçiləri siyahıya al / yarat
.../scim/v2/Users/{id} İstifadəçini oxu / yenilə / sil

SCIM son nöqtələri ilə təsdiqlənir hər-icarəçi SCIM gediş tokeni, verilib (və dövriyyəyə buraxılıb/ləğv edilib) POST /v1/admin/scim/token; IdP bunu bir Authorization: Bearer başlıq. Token yalnız buraxılış zamanı göstərilir.

OAuth tokeni

Metod və yol Məqsəd
POST /v1/oauth/token OAuth token nöqtəsi

MCP serveri (xaricə yayım)

AiHummer MCP müştərilərinə öz alətlərini yaymaq üçün kimi çıxış edə bilər MCP server. Bu qoşulmaq və aktiv olmayan olur, əgər siz təyin etməsəniz AIHUMMER_MCP_PUBLISH=1.

Metod və yol Məqsəd
POST /v1/mcp MCP server son nöqtəsi (tələb olunur AIHUMMER_MCP_PUBLISH=1)

[!WARNING] Tək AIHUMMER_MCP_PUBLISH=1 kifayət deyil. O, ünvanı açır, lakin ixrac siyahısı boş qalır: tools/list boş massiv qaytarır və hər çağırış rədd edilir. Lazımi alətləri AIHUMMER_MCP_EXPORT_TOOLS daxilində dəqiq adlarla, vergüllə ayıraraq sadalayın — şablonlar və * dəstəklənmir. Bayıra yalnız oxuma alətləri verilə bilər: http_request, web_fetch, browser, code_exec və filesystem_read adlarını yazsanız belə heç vaxt ixrac olunmur.

Hər iki parametr İdarəetmə → Parametrlər bölməsində və ya aihummer settings set əmri ilə verilir, gateway.env faylında yox — bu açarlar üçün mühit nəzərə alınmır. AIHUMMER_MCP_PUBLISH dəqiq 1 qəbul edir: true və ya on ünvanı bağlı saxlayacaq. Dəyişikliklər şlüz yenidən başladıldıqdan sonra qüvvəyə minir.

Müştəri Authorization: Bearer … başlığında mcp əhatəli API açarı göndərməlidir; onsuz cavab 401 olur.

[!NOTE] Yayınlama alətləri xaricə istiqamətləndirmək, MCP serverini istehlak etməkdən fərqlidir sıfır-kod inteqrasiyası. Bu uç nöqtə digər MCP müştərilərinin daxil olmasına imkan vermək üçündür AiHummer.

A2A (Agent-dən Agentə)

AiHummer digər agentlərin onu kəşf edib mesaj göndərə bilməsi üçün A2A səthi açıq edə bilər. Bu da qoşulmaq ilə AIHUMMER_A2A_PUBLISH=1.

Metod və yol Məqsəd
GET /.well-known/agent.json A2A agent kartı / kəşf sənədi
POST /a2a/message A2A mesajı alın (tələb olunur AIHUMMER_A2A_PUBLISH=1)

Media

Böyük media (səs, şəkillər, fayllar) JSON mətnlərində yerləşdirilmək əvəzinə xüsusi son nöqtələr vasitəsilə yüklənir və götürülür.

Metod və yol Məqsəd
PUT /v1/media/{id}/content Media obyekt üçün baytları yükləyin
GET /v1/files/{id} Saxlanılmış faylı yükləyin

[!TIP] Dəst AIHUMMER_BLOB_DIR media/fayl xidmətini aktiv etmək üçün və AIHUMMER_MEDIA_TOKEN_SECRET beləliklə imzalanmış yükləmə URL-ləri boyunca etibarlı qalır yenidən başlayır.

RPC xidmətlərinə qoşul

Yazılı, axınlı müştərilər üçün AiHummer də təqdim edir RPC-ə əlaqə HTTP üzərindən xidmətlər (server axınını dəstəkləyir):

Xidmət Sahə
aihummer.health.v1 Sağlamlıq yoxlamaları
aihummer.event.v1 Hadisə axını
aihummer.conversation.v1 Söhbətlər
aihummer.push.v1 Push çatdırılması
aihummer.media.v1 Media ötürülməsi
aihummer.turn.v1 Növbə icrası

Növbəti haradır