AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Webhooklar, SCIM we jübütleşme

Webhooklar, SCIM we jübütleşme

v1.0.x · täzelendi 2026-06-26

Bu sahypa galan protokol üstlerini öz içine alýar: enjam jübütleşmesi, kärhana auth federasiýasy (SAML / SCIM / OAuth), meýletin MCP serweri we A2A nokatlary, media geçirimi we Connect-RPC hyzmatlary. Olaryň birnäçesi deslapky ýagdaýda öçük we aç-açan açylmaly.

Enjam jübütleşmesi

Mobil we iş stoly müşderileri nusga gysga jübütleşme alyş-çalşygy arkaly goşulýar (iOS/macOS programmasy diňe QR jübütleşmesini ulanýar).

Usul we ýol Maksat
POST /v1/pairing/redeem Jübütleşme kodyny çalşyň we enjamy üpjün ediň
POST /v1/pairing/device/validate Eýýäm jübütleşdirilen enjamy barlaň 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Auth federasiýasy

AiHummer hem giriş hem-de ulanyjy üpjün etmesi üçin kärhana şahsyýet üpjün edijileri bilen integrirlenýär.

SAML

Usul we ýol Maksat
GET /saml/metadata IdP-niňiz üçin hyzmat üpjün ediji metadatasy
POST /saml/acs Assertion Consumer Service (SAML jogaby)
GET /saml/login SAML girişini başlat

SCIM üpjün etmesi

System for Cross-domain Identity Management (SCIM 2.0) IdP-niňize ulanyjylary awtomatiki döretmäge we dolandyrmaga mümkinçilik berýär.

Usul we ýol Maksat
.../scim/v2/Users Ulanyjylary sanaw / döret
.../scim/v2/Users/{id} Ulanyjyny oka / täzele / poz

OAuth belgisi

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

MCP serweri (daşaryk çykarmak)

AiHummer MCP serweri hökmünde hereket edip öz gurallaryny MCP müşderilerine çykaryp bilýär. Bu meýletin we AIHUMMER_MCP_PUBLISH=1 belländer öçük.

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

[!NOTE] Gurallary daşaryk çykarmak, MCP serwerini kodsuz integrasiýa hökmünde sarp etmekden tapawutlanýar. Bu nokat beýleki MCP müşderilerine AiHummer-e çagyrmaga rugsat bermek üçindir.

A2A (Agent-to-Agent)

AiHummer beýleki agentleriň ony tapyp we oňa habar iberip bilmegi üçin A2A üstüni açyp bilýär. Bu hem AIHUMMER_A2A_PUBLISH=1 arkaly meýletindir.

Usul we ýol Maksat
GET /.well-known/agent.json A2A agent karty / tapyş resminamasy
POST /a2a/message A2A habary al (AIHUMMER_A2A_PUBLISH=1 talap edýär)

Media

Uly media (audio, suratlar, faýllar) JSON bedenlerine içine goýulman, ýörite nokatlar arkaly ýüklenýär we alynýar.

Usul we ýol Maksat
PUT /v1/media/{id}/content Media obýekti üçin baýtlary ýükle
GET /v1/files/{id} Saklanan faýly ýükläp al

[!TIP] media/faýl hyzmatyny işjeňleşdirmek üçin AIHUMMER_BLOB_DIR belläň, gol çekilen ýükläp alyş URL-leri gaýtadan başlamalarda hereketde galar ýaly AIHUMMER_MEDIA_TOKEN_SECRET belläň.

Connect-RPC hyzmatlary

Tipli, akymly müşderiler üçin AiHummer şeýle hem HTTP üsti bilen Connect-RPC hyzmatlaryny hödürleýär (serwer-akymy goldanýar):

Hyzmat Ugur
aihummer.health.v1 Saglyk barlaglary
aihummer.event.v1 Waka akymy
aihummer.conversation.v1 Söhbetdeşlikler
aihummer.push.v1 Push ýetirimi
aihummer.media.v1 Media geçirimi
aihummer.turn.v1 Nobat ýerine ýetirimi

Indiki nirä