Webhooks, SCIM și împerechere

v1.0.x · actualizat 2026-06-26

Această pagină acoperă suprafețele de protocol rămase: împerecherea dispozitivelor, federația de autentificare de întreprindere (SAML / SCIM / OAuth), serverul MCP opt-in și endpointurile A2A, transferul de media și serviciile Connect-RPC. Mai multe dintre acestea sunt dezactivate implicit și trebuie activate explicit.

Împerecherea dispozitivelor

Clienții mobili și de desktop se alătură unei instanțe printr-un scurt schimb de împerechere (aplicația iOS/macOS folosește împerecherea doar prin QR).

Metodă și cale	Scop
`POST /v1/pairing/redeem`	Răscumpără un cod de împerechere și provizionează dispozitivul
`POST /v1/pairing/device/validate`	Validează un dispozitiv deja împerecheat

curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Federație de autentificare

AiHummer se integrează cu furnizorii de identitate de întreprindere atât pentru autentificare, cât și pentru provizionarea utilizatorilor.

SAML

Metodă și cale	Scop
`GET /saml/metadata`	Metadate de furnizor de serviciu pentru IdP-ul dumneavoastră
`POST /saml/acs`	Assertion Consumer Service (răspuns SAML)
`GET /saml/login`	Inițiază autentificarea SAML

Provizionare SCIM

System for Cross-domain Identity Management (SCIM 2.0) permite IdP-ului dumneavoastră să creeze și să gestioneze utilizatori automat.

Metodă și cale	Scop
`.../scim/v2/Users`	Listează / creează utilizatori
`.../scim/v2/Users/{id}`	Citește / actualizează / șterge un utilizator

Token OAuth

Metodă și cale	Scop
`POST /v1/oauth/token`	Endpoint de token OAuth

Server MCP (publicare către exterior)

AiHummer își poate publica propriile unelte către clienții MCP acționând ca un server MCP. Acest lucru este opt-in și dezactivat dacă nu setați AIHUMMER_MCP_PUBLISH=1.

Metodă și cale	Scop
`POST /v1/mcp`	Endpoint de server MCP (necesită `AIHUMMER_MCP_PUBLISH=1`)

[!NOTE] Publicarea uneltelor către exterior este distinctă de consumarea unui server MCP ca integrare fără cod. Acest endpoint este pentru a permite altor clienți MCP să apeleze în AiHummer.

A2A (Agent-to-Agent)

AiHummer poate expune o suprafață A2A astfel încât alți agenți să o poată descoperi și să-i poată trimite mesaje. Și acest lucru este opt-in prin AIHUMMER_A2A_PUBLISH=1.

Metodă și cale	Scop
`GET /.well-known/agent.json`	Card de agent A2A / document de descoperire
`POST /a2a/message`	Primește un mesaj A2A (necesită `AIHUMMER_A2A_PUBLISH=1`)

Media

Media de dimensiuni mari (audio, imagini, fișiere) este încărcată și preluată prin endpointuri dedicate, mai degrabă decât încorporată în corpuri JSON.

Metodă și cale	Scop
`PUT /v1/media/{id}/content`	Încarcă octeții pentru un obiect media
`GET /v1/files/{id}`	Descarcă un fișier stocat

[!TIP] Setați AIHUMMER_BLOB_DIR pentru a activa serviciul de media/fișiere și AIHUMMER_MEDIA_TOKEN_SECRET astfel încât URL-urile de descărcare semnate să rămână valide după reporniri.

Servicii Connect-RPC

Pentru clienți tipizați și în streaming, AiHummer expune de asemenea servicii Connect-RPC prin HTTP (streaming-ul de la server este acceptat):

Serviciu	Domeniu
`aihummer.health.v1`	Verificări de sănătate
`aihummer.event.v1`	Flux de evenimente
`aihummer.conversation.v1`	Conversații
`aihummer.push.v1`	Livrare push
`aihummer.media.v1`	Transfer de media
`aihummer.turn.v1`	Execuție de tură

Unde mai departe

Trimiteți mesaje în AiHummer: Declanșatoare de intrare și integrare.
Comutați aceste suprafețe și altele: Variabile de mediu.
Operați instanța: Referință CLI.