API Zugriff

Authentifizierung, Sicherheit und Best Practices.

Zugriff & Authentifizierung

  • Transport: Es werden ausschließlich HTTPS‑Anfragen akzeptiert.
  • Maschinenzugriff (Server‑zu‑Server): per Bearer Token in der Authorization‑Headerzeile. Tokens sind mandantenspezifisch und müssen serverseitig sicher verwaltet werden.

Header‑Beispiel

Authorization: Bearer <token>
Content-Type: application/json

Achtung:

Schlüsselverwaltung muss sicher erfolgen (Secret Manager/Deployment‑Secrets, keine Speicherung im Client). Token nur serverseitig einsetzen.

Fehlerbehandlung

  • 401 Unauthorized: Token fehlt/ungültig
  • 403 Forbidden: Berechtigung fehlt
  • 422 Unprocessable Entity: Validierungsfehler
  • 429 Too Many Requests: Rate-Limit erreicht
  • 5xx Serverfehler: Bitte mit Request-ID an Support