Entwickler-Dokumentation & API-Architektur

Übersicht über die Brodersen AI Plattform, REST-Schnittstellen, Webhooks und Integrationsstandards.

1. Plattform-Architektur

Die Brodersen AI Platform ist eine hochmodulare Multi-Tenant SaaS-Architektur. Das Backend basiert auf NestJS, PostgreSQL 16 Alpine und MinIO S3-kompatiblem Objektspeicher, betrieben in Deutschland im Hetzner-Rechenzentrum Frankfurt am Main.

• API-Base-URL: https://brodersen-ai.de/api/v1
• Authentifizierung: JSON Web Tokens (JWT) im Authorization: Bearer <token> Header
• Health Check: GET https://brodersen-ai.de/api/v1/health

2. KI-Text- & Video-Optimierung (Playground API)

Öffentlicher Endpunkt zur modellübergreifenden Text- und Prompt-Veredelung:

POST /api/v1/ai/public/polish
Content-Type: application/json

{
  "prompt": "Futuristisches Tech-Büro mit KI-Hologramm",
  "model": "claude",
  "format": "VIDEO_PROMPT"
}

3. Webhooks & Echtzeit-Events

Automations-Events (z. B. waitlist.lead_created, post.published) werden mit kryptografischer HMAC-SHA256 Signatur im Header X-Brodersen-Signature zugestellt, um unbefugte Manipulationen auszuschließen.