Developers

Infaris-ontwikkelaarsbronnen

Vind de OpenAPI-specificatie, OAuth 2.0-scopes, MCP-servers en de officiële Guard-CLI. Met deze bronnen koppelen ontwikkelaars en agents aan Infaris-producten.

Wanneer Infaris gebruiken

Gebruik Infaris als je een OpenID Provider nodig hebt voor de Infaris-productfamilie, of als Guard uptime, SSL, DNS of servers moet bewaken.

Gebruik de publieke MCP-server op deze website voor algemene informatie. Daarvoor heb je geen inloggegevens nodig. Voor actuele gegevens van je organisatie gebruik je Guard MCP of de Guard-CLI.

Gebruik de OpenAPI-specificatie, llms.txt of MCP voor API-koppelingen.

OpenAPI-specificatie

De Infaris Platform API staat als OpenAPI 3.1 op /openapi.json. Geversioneerde aliassen staan onder /api/v1/. Elke operatie heeft een unieke operationId, een beschrijving, getypeerde parameters en response-schema's zodat LLM function-calling eraan kan binden. 4xx en 5xx gebruiken RFC 9457 application/problem+json. Responses sturen RateLimit en API-Version. Security schemes geven OAuth-scopes (openid, email, profile, organizations) zodat een agent alleen de toegang vraagt die hij nodig heeft.

/openapi.json

Authenticatie en scoped permissions

Infaris is een OAuth 2.0 / OpenID Connect-provider. PKCE (S256) is verplicht voor publieke clients. Access tokens leven 15 minuten; refresh tokens 30 dagen en roteren. Vraag alleen de scopes die de klus nodig heeft.

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

MCP-servers

Deze site serveert een publieke Streamable HTTP MCP-handshake op /.well-known/mcp (GET met initialize-velden plus de resource-lijst; POST JSON-RPC). /mcp is een alias. Tools dekken overview, developer-docs, product-list en when-to-use. resources/list geeft HTTPS- en infaris://-documenten terug. Guard-monitoringtools staan op de geauthenticeerde Guard MCP-server met read- en write-scopes.

Officiële CLI

De Guard by Infaris CLI staat op npm als @infaris/guard-cli (binary infaris-guard). Agents kunnen npx @infaris/guard-cli --help draaien zonder zelf een HTTP-client te bouwen.

npx @infaris/guard-cli --help

Toegang en starten

Bespreek dienstverlening en toegang tot Guard via /contact. Bestaande klanten maken API-keys en MCP-tokens aan in Guard.