AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Webhooks, SCIM we Jupleşdirmek

Webhooks, SCIM we Jupleşdirmek

v1.1.x · täzelendi 2026-07-05

Bu sahypa galan protokol ýüzlerini öz içine alýar: enjam birikdirmek, telekeçilik awt federasiýasy (SAML / SCIM / OAuth), saýlamaly MCP serveri we A2A ahyrylary, mediýa geçiriş we RPC bilen baglan hizmatlar. Munlaryň käbiri adaty ýagdaýda öçürilen bolýar we anyk görkezme bilen işjeňleşdirilmeli.

Enjam birikdirmek

Mobil we iş stoluly müşderiler gysga juwan ulanyş üsti bilen instansýa goşulýarlar (iOS/macOS programmasy diňe QR bilen juwan ulanyşdan peýdalanýar).

Usul we ýol Maksat
POST /v1/pairing/redeem Jübütleme koduny gaýtadan öňüni alyň we enjami üpjün ediň
POST /v1/pairing/device/validate Täze baglanan enjami tassykla 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Awt federasiýasy

AiHummer giriş we ulanyjy üpjünçiligi üçin kärhanalaryň şahsyýet üpjün edijileri bilen birleşýär.

SAML

Usul we ýol Maksat
GET /saml/metadata Siziň IdP üçin hyzmat üpjün ediji metadata
POST /saml/acs Tassyklama Alyjy Gullugy (SAML jogaby)
GET /saml/login SAML hasaba girişini başlat

SCIM üpjünçiligi

Çapraz ulgamlaryň şahsyýet dolandyryş ulgamy (SCIM 2.0) IdPňiz üçin ulanyjylary awtomatiki döredmäge we dolandyrmaga mümkinçilik berýär.

Usul we ýol Maksat
.../scim/v2/Users Ulanyjylary sanawlamak / döretmek
.../scim/v2/Users/{id} Ulanyjyny oka / täzelä / poz

SCIM uç noktalary bilen birine şahsyýet öňüni alyş prosedurasy amala aşyrýar ýaňa-işgäri SCIM elýeterlik nyşany, berlen (we öwürlen/yzo öňki ýagdaýyna getirilen) wagty POST /v1/admin/scim/token; IdP ony içinde iberýär Authorization: Bearer baş sahypa. Token çykaryş wagtynda bir gezek görkezilýär.

OAuth tokeni

Usul we ýol Maksat
POST /v1/oauth/token OAuth token nokady

MCP serveri (daşar çykarmak üçin neşir etmek)

AiHummer MCP müşderilerine öz gurallaryny çap edip biler MCP serveri. Bu azat taýdan gatnaşmak we ýapyk bolar, bolmasa siz sazlamasaňyz AIHUMMER_MCP_PUBLISH=1.

Usul we ýol Maksat
POST /v1/mcp MCP serverine uç nokady (talap edýär AIHUMMER_MCP_PUBLISH=1)

[!WARNING] Diňe AIHUMMER_MCP_PUBLISH=1 ýeterlik däl. Ol salgyny açýar, ýöne eksport sanawy boş: tools/list boş massiw gaýtarýar we islendik çagyryş ret edilýär. Gerekli gurallary AIHUMMER_MCP_EXPORT_TOOLS içinde takyk atlary bilen, otur arkaly bölüp sanaň — nusgalar we * goldanylmaýar. Daşyna diňe okaýan gurallar berlip bilner: http_request, web_fetch, browser, code_exec we filesystem_read ýazsaňyz-da hiç haçan eksport edilmeýär.

Iki sazlama-da Dolandyryş → Sazlamalar bölüminde ýa-da aihummer settings set buýrugy bilen berilýär, gateway.env içinde däl — bu açarlar üçin daşky gurşaw äsgerilmeýär. AIHUMMER_MCP_PUBLISH takyk 1 kabul edýär: true ýa-da on salgyny ýapyk goýar. Üýtgeşmeler derweze täzeden başladylandan soň güýje girýär.

Müşderi Authorization: Bearer … sözbaşysynda mcp gerimli API açaryny ibermelidir; onsuz jogap 401 bolýar.

[!NOTE] Daşarky neşir serişdelerini çykarmak, MCP serverini ulanylýan hökmünde ulanylyşyndan tapawutlanýar kodsyz integrasiýa. Bu nokat beýleki MCP müşderileriniň içine çagyryş etmegine mümkinçilik bermek üçin AiHummer.

A2A (Agent-den-Agent-e)

AiHummer başga agentleriň ony tapyp habarlaşyp bilmegi üçin A2A ýüzüni açyp biler. Bu hem azat taýdan gatnaşmak üsti bilen AIHUMMER_A2A_PUBLISH=1.

Usul we ýol Maksat
GET /.well-known/agent.json A2A agent kartasy / gözleg resminamasy
POST /a2a/message A2A habaryny alyň (talap edýär AIHUMMER_A2A_PUBLISH=1)

Media

Uly media (ses, suratlardyr faýllar) JSON bedeniň içine goşulman, ýörite nokatlar arkaly ýüklän we alnan bolýar.

Usul we ýol Maksat
PUT /v1/media/{id}/content Medýa obýekti üçin baitlary ýükläň
GET /v1/files/{id} Saklanan faýly ýükläň

[!TIP] Toplum AIHUMMER_BLOB_DIR mediýa/faýl hyzmatyny işjeňleşdirmek üçin, we AIHUMMER_MEDIA_TOKEN_SECRET şeýlelik bilen gol çekilen göçürme URL-leri geçerli ýagdaýda galýar täzeden başlamalar.

RPC hyzmatlaryna birikmek

Ýazylan, akymly müşderiler üçin AiHummer hem açýar RPC bilen baglan HTTP arkaly hyzmatlar (serwer akym desteklenýär):

Hyzmat Sebit
aihummer.health.v1 Saglyk barlaglary
aihummer.event.v1 Waka akymy
aihummer.conversation.v1 Söhbetler
aihummer.push.v1 Itergi eltip bermek
aihummer.media.v1 Medýa geçirmek
aihummer.turn.v1 Ýerine ýetirişi öwürmek

Indi nire?