Webhooks, SCIM we Jupleşdirmek

v1.2.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?

AiHummer-e habarlary itekle: Içeri giriş we integrasiýa tetikleýjiler.
Bu ýüzleri we has köp zady üýtgediň: Çevre üýtgeýjileri.
Instansy işlediň: CLI salgysy.