AiHummer
Latviešu▾
PierakstītiesKonts
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Tīmekļa āķi, SCIM un savienošana

Tīmekļa āķi, SCIM un savienošana

v1.0.x · atjaunināts 2026-07-05

Šī lapa aptver pārējās protokola virsmas: ierīču pārošana, uzņēmums autentifikācijas federācija (SAML / SCIM / OAuth), izvēle pieslēgties MCP serveris un A2A galapunkti, mediji pārvietot, un Savienot-RPC pakalpojumi. Daži no tiem pēc noklusējuma ir izslēgti un tos jāieslēdz īpaši.

Ierīču savienošana

Mobilie un galddatoru klienti pievienojas instancē, izmantojot īsu savienošanās apmaiņu (iOS/macOS lietotne izmanto tikai QR savienošanu).

Metode un ceļš Mērķis
POST /v1/pairing/redeem Ievadiet pārašanas kodu un sagatavojiet ierīci
POST /v1/pairing/device/validate Pārbaudīt jau savienotu ierīci 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Autentifikācijas federācija

AiHummer integrējas ar uzņēmuma identitātes nodrošinātājiem gan pieteikšanās, gan lietotāju nodrošināšanas vajadzībām.

SAML

Metode un ceļš Mērķis
GET /saml/metadata Pakalpojumu sniedzēja metadati jūsu IdP
POST /saml/acs Apgalvojuma patērētāja pakalpojums (SAML atbilde)
GET /saml/login Sākt SAML pieteikšanos

SCIM nodrošināšana

Sistēma lietotāju identitātes pārvaldībai dažādās jomās (SCIM 2.0) ļauj jūsu IdP automātiski izveidot un pārvaldīt lietotājus.

Metode un ceļš Mērķis
.../scim/v2/Users Saraksts / izveidot lietotājus
.../scim/v2/Users/{id} Lasīt / atjaunināt / dzēst lietotāju

SCIM galapunkti autentificējas ar SCIM nēsātāja marķieris katram īrniekam, izsniegts (un pagriezts/atsaukts) pie POST /v1/admin/scim/token; IdP to to nosūta Authorization: Bearer galvene. Žetons tiek parādīts tikai izsniegšanas brīdī.

OAuth žetons

Metode un ceļš Mērķis
POST /v1/oauth/token OAuth žetona galapunkts

MCP serveris (publicēt uz āru)

AiHummer var publicēt savus rīkus MCP klientiem, rīkojoties kā MCP serveris. Tas ir piedalīties un atspējots, ja vien neiestatīsit AIHUMMER_MCP_PUBLISH=1.

Metode un ceļš Mērķis
POST /v1/mcp MCP servera galapunkts (prasa AIHUMMER_MCP_PUBLISH=1)

[!WARNING] Ar vienu AIHUMMER_MCP_PUBLISH=1 nepietiek. Tas atver adresi, bet eksporta saraksts ir tukšs: tools/list atgriež tukšu masīvu un jebkurš izsaukums tiek noraidīts. Uzskaitiet vajadzīgos rīkus ar precīziem nosaukumiem, atdalot ar komatu, iestatījumā AIHUMMER_MCP_EXPORT_TOOLS — šabloni un * netiek atbalstīti. Uz āru drīkst publicēt tikai lasīšanas rīkus: http_request, web_fetch, browser, code_exec un filesystem_read netiek eksportēti nekad, pat ja tos nosauksiet.

Abus iestatījumus norāda sadaļā Pārvaldība → Iestatījumi vai ar komandu aihummer settings set, nevis failā gateway.env — šīm atslēgām vide tiek ignorēta. AIHUMMER_MCP_PUBLISH pieņem tieši 1: true vai on atstās adresi slēgtu. Izmaiņas stājas spēkā pēc vārtejas pārstartēšanas.

Klientam galvenē Authorization: Bearer … jāatsūta API atslēga ar mcp tvērumu; bez tās atbilde ir 401.

[!NOTE] Publicēšanas rīki ārēji atšķiras no MCP servera patēriņa kā nulles koda integrācija. Šis galapunkts ir paredzēts, lai ļautu citiem MCP klientiem izsaukt AiHummer.

A2A (Aģenta uz Aģentu)

AiHummer var atklāt A2A virsmu, lai citi aģenti to varētu atklāt un nosūtīt ziņojumu. Tas arī piedalīties caur AIHUMMER_A2A_PUBLISH=1.

Metode un ceļš Mērķis
GET /.well-known/agent.json A2A aģenta karte / atklāšanas dokuments
POST /a2a/message Saņemt A2A ziņu (prasa AIHUMMER_A2A_PUBLISH=1)

Mediji

Lielie multivides faili (audio, attēli, faili) tiek augšupielādēti un iegūti caur speciālām galapunktiem, nevis iegulti JSON struktūrās.

Metode un ceļš Mērķis
PUT /v1/media/{id}/content Augšupielādējiet baitus multivides objektam
GET /v1/files/{id} Lejupielādēt saglabāto failu

[!TIP] Komplekts AIHUMMER_BLOB_DIR lai iespējotu multivides/failu pakalpojumu, un AIHUMMER_MEDIA_TOKEN_SECRET tātad parakstītie lejupielādes URL paliek derīgi pāri pārstartējas.

Savienot RPC pakalpojumus

Tīpētiem, straumējošiem klientiem AiHummer arī atklāj Savienot-RPC pakalpojumi pār HTTP (atbalstīta servera plūsma):

Pakalpojums Laukums
aihummer.health.v1 Veselības pārbaudes
aihummer.event.v1 Notikumu plūsma
aihummer.conversation.v1 Sarunas
aihummer.push.v1 Push piegāde
aihummer.media.v1 Mediju pārsūtīšana
aihummer.turn.v1 Izpildes kārta

Kur uz nākamo