Webbhookar, SCIM och Parkoppling

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

Denna sida täcker de återstående protokollytorna: **enhetsparning**, företag **autentiseringsfederation** (SAML / SCIM / OAuth), valfri **MCP-server** och **A2A** ändpunkter, **media** överföring, och **Anslut-RPC** tjänster. Flera av dessa är avstängda som standard och måste aktiveras uttryckligen. ## Enhet ihopparning Mobila och stationära klienter ansluter till en instans genom en kort parningsutbyte (iOS/macOS-appen använder endast QR-parning). | Metod & sökväg | Syfte | |---|---| | `POST /v1/pairing/redeem` | Lös in en parkoder och konfigurera enheten | | `POST /v1/pairing/device/validate` | Verifiera en redan parad enhet | ```bash curl https://your-aihummer.example/v1/pairing/redeem \ -H "Content-Type: application/json" \ -d '{ "code": "ABCD-EFGH" }' ``` ## Autentiseringsfederation AiHummer integreras med företagsidentitetsleverantörer för både inloggning och användarhantering. ### SAML | Metod & sökväg | Syfte | |---|---| | `GET /saml/metadata` | Tjänsteleverantörens metadata för din IdP | | `POST /saml/acs` | Assertion Consumer-tjänst (SAML-svar) | | `GET /saml/login` | Initiera SAML-inloggning | ### SCIM-provisionering System för hantering av identitet över domäner (SCIM 2.0) låter din IdP skapa och hantera användare automatiskt. | Metod & sökväg | Syfte | |---|---| | `.../scim/v2/Users` | Lista / skapa användare | | `.../scim/v2/Users/{id}` | Läs / uppdatera / ta bort en användare | SCIM-slutpunkterna autentiserar med en **per hyresgäst SCIM-bärare token**, utfärdad (och roterad/återkallad) vid `POST /v1/admin/scim/token`; IdP skickar den i en `Authorization: Bearer` huvud. Token visas en gång vid utfärdandet. ### OAuth-token | Metod & sökväg | Syfte | |---|---| | `POST /v1/oauth/token` | OAuth-tokenändpunkt | ## MCP-server (publicera utåt) AiHummer kan publicera sina egna verktyg till MCP-klienter genom att agera som en **MCP-server**. Detta är **anmäla sig** och inaktiverad om du inte ställer in `AIHUMMER_MCP_PUBLISH=1`. | Metod & sökväg | Syfte | |---|---| | `POST /v1/mcp` | MCP-serverändpunkt (kräver `AIHUMMER_MCP_PUBLISH=1`) | > [!WARNING] > **Enbart `AIHUMMER_MCP_PUBLISH=1` räcker inte.** Den öppnar adressen, men > exportlistan är tom: `tools/list` returnerar en tom array och varje anrop > avvisas. Räkna upp verktygen med **exakta namn, kommaseparerade**, i > `AIHUMMER_MCP_EXPORT_TOOLS` — mönster och `*` stöds inte. Utåt får bara > **läsande** verktyg publiceras: `http_request`, `web_fetch`, `browser`, > `code_exec` och `filesystem_read` exporteras aldrig, även om du namnger dem. > > Båda inställningarna sätts i **Hantering → Inställningar** eller med > `aihummer settings set`, inte i `gateway.env` — miljön ignoreras för dessa > nycklar. `AIHUMMER_MCP_PUBLISH` accepterar exakt `1`: `true` eller `on` > lämnar adressen stängd. Ändringar gäller efter omstart av gatewayen. > > Klienten måste skicka en API-nyckel med omfattningen `mcp` i huvudet > `Authorization: Bearer …`; utan den blir svaret 401. > [!NOTE] > Att publicera verktyg utåt är skilt från att *använda* en MCP-server som en > noll-kod integration. Denna slutpunkt är för att låta andra MCP-klienter anropa > AiHummer. ## A2A (Agent-till-Agent) AiHummer kan exponera en A2A-yta så att andra agenter kan upptäcka och skicka meddelanden till den. Detta är också **anmäla sig** via `AIHUMMER_A2A_PUBLISH=1`. | Metod & sökväg | Syfte | |---|---| | `GET /.well-known/agent.json` | A2A-agentkort / upptäcktsdokument | | `POST /a2a/message` | Ta emot ett A2A-meddelande (kräver `AIHUMMER_A2A_PUBLISH=1`) | ## Media Stora medier (ljud, bilder, filer) laddas upp och hämtas genom dedikerade endpoints istället för att bäddas in i JSON-kroppar. | Metod & sökväg | Syfte | |---|---| | `PUT /v1/media/{id}/content` | Ladda upp bytena för ett medieobjekt | | `GET /v1/files/{id}` | Ladda ner en sparad fil | > [!TIP] > Sätta `AIHUMMER_BLOB_DIR` för att aktivera media-/filservicen, och > `AIHUMMER_MEDIA_TOKEN_SECRET` så att signerade nedladdnings-URL:er förblir giltiga över > startar om. ## Anslut-RPC-tjänster För typade, strömmande klienter exponerar AiHummer också **Anslut-RPC** tjänster över HTTP (server-streaming stöds): | Service | Område | |---|---| | `aihummer.health.v1` | Hälsokontroller | | `aihummer.event.v1` | Evenemangsström | | `aihummer.conversation.v1` | Samtal | | `aihummer.push.v1` | Pushleverans | | `aihummer.media.v1` | Mediadelning | | `aihummer.turn.v1` | Utförande av tur | ## Vart härnäst - Skjut meddelanden in i AiHummer: [Inbound- och integrationstriggers](/sv/v1.0/api/inbound-triggers). - Växla mellan dessa ytor och fler: [Miljövariabler](/sv/v1.0/reference/env-vars). - Verkställ instansen: [CLI-referens](/sv/v1.0/reference/cli).