AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Webhooks, SCIM ja Paritus

Webhooks, SCIM ja Paritus

v1.1.x · päivitetty 2026-07-05

Tämä sivu kattaa jäljellä olevat protokollapinnat: laitteen yhdistäminen, yritys todennusliittouma (SAML / SCIM / OAuth), valinnainen osallistuminen MCP-palvelin ja A2A päätteet, media siirto, ja Yhdistä-RPC palvelut. Useat näistä ovat oletuksena pois päältä ja ne on otettava käyttöön erikseen.

Laitteen yhdistäminen

Mobiili- ja työpöytäasiakkaat liittyvät instanssiin lyhyen yhdistämisvaihdon kautta (iOS-/macOS-sovellus käyttää vain QR-yhdistämistä).

Menetelmä & polku Tarkoitus
POST /v1/pairing/redeem Lunasta parikoodin ja ota laite käyttöön
POST /v1/pairing/device/validate Vahvista jo pariksi liitetty laite 
curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Todennuksen yhdistäminen

AiHummer integroituu yritysten identiteetin tarjoajiin sekä kirjautumista että käyttäjien hallintaa varten.

SAML

Menetelmä & polku Tarkoitus
GET /saml/metadata Palveluntarjoajan metatiedot IdP:llesi
POST /saml/acs Väittämän vastaanottopalvelu (SAML-vastaus)
GET /saml/login Aloita SAML-kirjautuminen

SCIM-tarjonta

Cross-domain Identity Management -järjestelmä (SCIM 2.0) antaa IdP:si luoda ja hallita käyttäjiä automaattisesti.

Menetelmä & polku Tarkoitus
.../scim/v2/Users Listaa / luo käyttäjiä
.../scim/v2/Users/{id} Lue / päivitä / poista käyttäjä

SCIM-päätepisteet todentavat käyttäen vuokraaja-kohtainen SCIM-haltijatunnus, myönnetty (ja kierrätetty/peruutettu) kohdassa POST /v1/admin/scim/token; IdP lähettää sen Authorization: Bearer otsikko. Tunnus näytetään kerran myöntöhetkellä.

OAuth-tunnus

Menetelmä & polku Tarkoitus
POST /v1/oauth/token OAuth-tunnistepäätepiste

MCP-palvelin (julkaise ulospäin)

AiHummer voi julkaista omia työkalujaan MCP-asiakkaille toimimalla MCP-palvelin. Tämä on osallistua vapaaehtoisesti ja pois käytöstä, ellei määritä AIHUMMER_MCP_PUBLISH=1.

Menetelmä & polku Tarkoitus
POST /v1/mcp MCP-palvelimen päätepiste (vaatii AIHUMMER_MCP_PUBLISH=1)

[!WARNING] Pelkkä AIHUMMER_MCP_PUBLISH=1 ei riitä. Se avaa osoitteen, mutta vientilista on tyhjä: tools/list palauttaa tyhjän taulukon ja jokainen kutsu hylätään. Luettele haluamasi työkalut tarkoilla nimillä pilkuin eroteltuna asetuksessa AIHUMMER_MCP_EXPORT_TOOLS — jokerimerkkejä tai *-merkkiä ei tueta. Ulos saa julkaista vain lukevia työkaluja: http_request, web_fetch, browser, code_exec ja filesystem_read eivät koskaan päädy vientiin, vaikka nimeäisit ne.

Molemmat asetukset annetaan kohdassa Hallinta → Asetukset tai komennolla aihummer settings set, ei tiedostossa gateway.env — ympäristömuuttujat ohitetaan näiden avainten kohdalla. AIHUMMER_MCP_PUBLISH hyväksyy täsmälleen arvon 1: true tai on jättävät osoitteen kiinni. Muutokset tulevat voimaan yhdyskäytävän uudelleenkäynnistyksen jälkeen.

Asiakkaan on lähetettävä API-avain, jolla on mcp-oikeusalue, otsakkeessa Authorization: Bearer …; ilman sitä vastaus on 401.

[!NOTE] Julkaisutyökalujen tarjoaminen ulospäin on erilaista kuin MCP-palvelimen kuluttaminen yhtenä nollakoodinen integraatio. Tämä päätepiste on tarkoitettu muiden MCP-asiakkaiden kutsumiseen AiHummer.

A2A (Agentista agenttiin)

AiHummer voi paljastaa A2A-pinnan, jotta muut agentit voivat löytää sen ja lähettää sille viestejä. Tämä on myös osallistua vapaaehtoisesti kautta AIHUMMER_A2A_PUBLISH=1.

Menetelmä & polku Tarkoitus
GET /.well-known/agent.json A2A-agenttikortti / löytymismuodokumentti
POST /a2a/message Vastaanota A2A-viesti (vaatii AIHUMMER_A2A_PUBLISH=1)

Media

Suuri media (ääni, kuvat, tiedostot) ladataan ja haetaan omien päätepisteidensä kautta sen sijaan, että ne upotettaisiin JSON-rakenteisiin.

Menetelmä & polku Tarkoitus
PUT /v1/media/{id}/content Lataa tavut mediakohteelle
GET /v1/files/{id} Lataa tallennettu tiedosto

[!TIP] Asettaa AIHUMMER_BLOB_DIR ottaaksesi mediapalvelun/tiedostopalvelun käyttöön, ja AIHUMMER_MEDIA_TOKEN_SECRET jotta allekirjoitetut lataus-URL-osoitteet pysyvät voimassa käynnistyy uudelleen.

Connect-RPC-palvelut

Kirjoitetuille, suoratoistaville asiakkaille AiHummer myös paljastaa Yhdistä-RPC palvelut HTTP:n yli (palvelinvirtausta tuetaan):

Palvelu Alue
aihummer.health.v1 Terveystarkastukset
aihummer.event.v1 Tapahtumavirta
aihummer.conversation.v1 Keskustelut
aihummer.push.v1 Push-toimitus
aihummer.media.v1 Median siirto
aihummer.turn.v1 Vuoron suorittaminen

Minne seuraavaksi