API-Dokumentation

Diese API ist primaer fuer KI-Agenten und programmatische Integrationen gedacht. Endpoints unterstuetzen Lead-Submission, Tool-/Magazin-Suche via MCP und Health-Checks.

Einstiegspunkte

• OpenAPI Spec: /.well-known/openapi.yaml
• MCP Server-Card: /.well-known/mcp/server-card.json
• API-Catalog (RFC 9727): /.well-known/api-catalog
• OAuth Discovery: /.well-known/oauth-authorization-server
• OpenID Connect: /.well-known/openid-configuration
• Agent-Skills: /.well-known/agent-skills/index.json
• llms.txt: /llms.txt
• Health: /api/health

MCP-Endpoint

POST https://business.digital/mcp. JSON-RPC 2.0, Methoden tools/list und tools/call. Lese-Tools sind oeffentlich, Schreib-Tools (Lead-Submission) erfordern einen OAuth Bearer Token mit Scope lead.write.

OAuth 2.0

Token-Endpoint /api/oauth/token, JWKS unter /api/oauth/jwks. Unterstuetzte Grants: client_credentials und authorization_code (mit PKCE S256).

Markdown-Variante jeder Seite

Jede oeffentliche HTML-Seite ist auch in Markdown verfuegbar. Sende Accept: text/markdown oder rufe <url>/index.md direkt auf.

Interaktive Dokumentation

Die OpenAPI-Spec laesst sich in jedem Standard-Tool wie Redoc, Swagger UI, Postman oder Insomnia laden. Aus Performance-Gruenden binden wir hier kein externes Renderer-Skript ein.

OpenAPI YAML herunterladen