Developers

Infaris-Entwicklerressourcen

OpenAPI, OAuth-2.0-Scopes, Streamable HTTP MCP, die offizielle CLI und ein Self-Serve-Test. Gebaut, damit Agents und Menschen integrieren können, ohne ein Verkaufsgespräch zu brauchen.

Wann Infaris einsetzen

Nutzen Sie Infaris, wenn Sie einen OpenID Provider für die Infaris-Produktfamilie brauchen oder wenn Guard Uptime, SSL, DNS oder Server überwachen soll.

Nutzen Sie den öffentlichen MCP-Server auf diesem Host zur Orientierung (keine Zugangsdaten nötig). Nutzen Sie Guard MCP oder die Guard-CLI, wenn Sie live Tenant-Daten benötigen.

Scrapen Sie nicht das Marketing-HTML für API-Verträge. Beginnen Sie bei OpenAPI, llms.txt oder MCP.

OpenAPI-Spezifikation

Die Infaris Platform API ist als OpenAPI 3.1 unter /openapi.json veröffentlicht. Versionierte Aliasse liegen unter /api/v1/. Jede Operation hat eine eindeutige operationId, eine Beschreibung, typisierte Parameter und Response-Schemas, damit LLM-Function-Calling daran andocken kann. 4xx und 5xx nutzen RFC 9457 application/problem+json. Responses senden RateLimit und API-Version. Security-Schemes deklarieren OAuth-Scopes (openid, email, profile, organizations), sodass ein Agent nur den Zugriff anfordert, den er braucht.

/openapi.json

Authentifizierung und Scoped Permissions

Infaris ist ein OAuth-2.0-/OpenID-Connect-Provider. PKCE (S256) ist für öffentliche Clients verpflichtend. Access Tokens gelten 15 Minuten; Refresh Tokens 30 Tage und rotieren. Fordern Sie nur die Scopes an, die die jeweilige Aufgabe braucht.

Discovery: /.well-known/openid-configuration
Scopes: openid, email, profile, organizations
Authorize: /api/oauth/authorize
Token: /api/oauth/token
UserInfo: /api/oauth/userinfo

MCP-Server

Diese Seite stellt einen öffentlichen Streamable-HTTP-MCP-Handshake unter /.well-known/mcp bereit (GET mit initialize-Feldern plus der Ressourcenliste; POST JSON-RPC). /mcp ist ein Alias. Tools decken overview, developer-docs, product-list und when-to-use ab. resources/list liefert HTTPS- und infaris://-Dokumente zurück. Guards Monitoring-Tools liegen auf dem authentifizierten Guard-MCP-Server mit Lese- und Schreib-Scopes.

Offizielle CLI

Die Guard-by-Infaris-CLI ist auf npm als @ipulsehq/pulseguard-cli verfügbar (Binaries pulseguard und pg). Agents können npx @ipulsehq/pulseguard-cli --help ausführen, ohne selbst einen HTTP-Client zu bauen.

npx @ipulsehq/pulseguard-cli --help

Self-Serve-Onboarding

Kostenlose Produkte: Files, QR und Sync benötigen nur ein Konto. Guard-Abonnements gibt es unter /pricing und starten, sobald Stripe die Zahlung bestätigt. Nach der Registrierung unter /sign-up öffnen Sie Guard und erstellen selbst einen API-Key oder MCP-Token im Dashboard. Sandbox: Identity-Preview unter https://dev.infaris.com; Guard-Staging unter https://acc.guard.ipulse.one.