AiHummer
Eesti▾
SisselogimineKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Veebikonksud, SCIM ja sidumine

Veebikonksud, SCIM ja sidumine

v1.0.x · uuendatud 2026-07-05

See lehekülg käsitleb ülejäänud protokolli pindu: seadme sidumine, ettevõte autentimise liit (SAML / SCIM / OAuth), valikuline liitumine MCP server ja A2A otsapunktid, meedia ülekanne, ja Ühenda-RPC teenused. Mõned neist on vaikimisi välja lülitatud ja need tuleb sisse lülitada eraldi.

Seadme sidumine

Mobiili- ja töölaua kliendid liituvad instantsiga lühikese sidumisvahetuse kaudu (iOS/macOS rakendus kasutab ainult QR-koodi sidumist).

Meetod ja tee Eesmärk
POST /v1/pairing/redeem Lunasta paarituskood ja seadista seade
POST /v1/pairing/device/validate Valeeri juba ühendatud seade 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Autentimise liit

AiHummer integreerub ettevõtte identiteedipakkujatega nii sisselogimiseks kui ka kasutajate haldamiseks.

SAML

Meetod ja tee Eesmärk
GET /saml/metadata Teenusepakkuja metaandmed teie IdP jaoks
POST /saml/acs Tõestuse tarbijateenus (SAML vastus)
GET /saml/login Alusta SAML-i sisselogimist

SCIM-i varustamine

Cross-domain Identity Management (SCIM 2.0) süsteem võimaldab teie IdP-l kasutajaid automaatselt luua ja hallata.

Meetod ja tee Eesmärk
.../scim/v2/Users Kuva / loo kasutajad
.../scim/v2/Users/{id} Loe / uuenda / kustuta kasutajat

SCIM-i lõpp-punktid autentivad koos ühikuüürniku SCIM-i kandjatoken, välja antud (ja uuendatud/kehtetuks tunnistatud) POST /v1/admin/scim/token; IdP saadab selle sisse Authorization: Bearer päis. Tähis kuvatakse üks kord väljaandmise ajal.

OAuthi märge

Meetod ja tee Eesmärk
POST /v1/oauth/token OAuth-i tokeni lõpp-punkt

MCP server (välja suunamine)

AiHummer saab oma tööriistu MCP klientidele avaldada, tegutsedes kui MCP server. See on osalemiseks ja keelatud, kui te ei määra AIHUMMER_MCP_PUBLISH=1.

Meetod ja tee Eesmärk
POST /v1/mcp MCP serveri lõpp-punkt (nõuab AIHUMMER_MCP_PUBLISH=1)

[!WARNING] Ainuüksi AIHUMMER_MCP_PUBLISH=1 ei piisa. See avab aadressi, kuid ekspordinimekiri on tühi: tools/list tagastab tühja massiivi ja iga väljakutse lükatakse tagasi. Loetle soovitud tööriistad täpsete nimedega, komadega eraldatult sättes AIHUMMER_MCP_EXPORT_TOOLS — mustreid ega * ei toetata. Väljapoole tohib avaldada ainult lugemistööriistu: http_request, web_fetch, browser, code_exec ja filesystem_read ei ekspordita kunagi, isegi kui need nimetada.

Mõlemad sätted määratakse jaotises Haldus → Sätted või käsuga aihummer settings set, mitte failis gateway.env — nende võtmete puhul keskkonda ei arvestata. AIHUMMER_MCP_PUBLISH võtab vastu täpselt 1: true või on jätavad aadressi suletuks. Muudatused jõustuvad pärast lüüsi taaskäivitust.

Klient peab saatma mcp ulatusega API-võtme päises Authorization: Bearer …; ilma selleta on vastus 401.

[!NOTE] Väliste väljaandmise tööriistade kasutamine erineb MCP serveri tarbimisest kui null-koodi integratsioon. See lõpp-punkt on mõeldud selleks, et lubada teistel MCP klientidel sisse helistada AiHummer.

A2A (Agent-agentile)

AiHummer saab avaldada A2A pinna, et teised agendid saaksid selle avastada ja sõnumeid saata. See on ka osalemiseks kaudu AIHUMMER_A2A_PUBLISH=1.

Meetod ja tee Eesmärk
GET /.well-known/agent.json A2A agendi kaart / avastusdokument
POST /a2a/message Vastuvõta A2A sõnum (nõuab AIHUMMER_A2A_PUBLISH=1)

Meedia

Suurt meediat (heli, pildid, failid) üles laaditakse ja hangitakse pühendatud lõpp-punktide kaudu, mitte JSON-kehadesse sisestatult.

Meetod ja tee Eesmärk
PUT /v1/media/{id}/content Laadi üles meediumobjekti baitid
GET /v1/files/{id} Laadi alla salvestatud fail

[!TIP] Seadistama AIHUMMER_BLOB_DIR meedia/failiteenuse lubamiseks, ja AIHUMMER_MEDIA_TOKEN_SECRET nii et allalaadimise URL-id jäävad kehtima kogu taaskäivitab.

Ühenda RPC-teenustega

Tippimise ja voogesituse klientide jaoks avaldab AiHummer ka Ühenda-RPC teenused üle HTTP (serveri voogedastus on toetatud):

Teenindus Pindala
aihummer.health.v1 Tervisekontrollid
aihummer.event.v1 Sündmuste voog
aihummer.conversation.v1 Vestlused
aihummer.push.v1 Push-tarne
aihummer.media.v1 Meedia ülekandmine
aihummer.turn.v1 Tegevuse sooritamine

Kuhu järgmine