Audit API

ENTWURF — Nur für interne Entwicklerteams

Diese API-Referenz ist für interne Entwicklerteams bestimmt.

Übersicht

Was es ist: Die Audit-API bietet Zugriff auf Audit-Protokolle, Metriken und Dashboard-Ansichten zur Verfolgung von Plattformaktivitäten und Compliance.

Endpunkte

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
GET	/internal/v1/audit/logs	Audit-Protokolleinträge auflisten	JWT + API-Token
GET	/internal/v1/audit/metrics	Audit-Metrikzusammenfassung abrufen	JWT + API-Token
GET	/internal/v1/audit/metrics/chart	Audit-Metrik-Diagrammdaten abrufen	JWT + API-Token
GET	/internal/v1/audit/dashboard	Audit-Dashboard-Übersicht abrufen	JWT + API-Token

---

GET /internal/v1/audit/logs

Audit-Protokolleinträge mit optionaler Filterung auflisten.

Anfrage:

GET /internal/v1/audit/logs?from=2026-02-01&to=2026-02-12&action=login
Authorization: Bearer <token>

Antwort (200):

{
  "logs": [
    {
      "timestamp": "2026-02-12T09:15:00Z",
      "action": "login",
      "userId": "user-uuid",
      "ip": "10.0.1.50",
      "result": "success"
    }
  ],
  "totalCount": 245
}

---

GET /internal/v1/audit/metrics

Eine Zusammenfassung der Audit-Metriken abrufen.

Anfrage:

GET /internal/v1/audit/metrics
Authorization: Bearer <token>

Antwort (200):

{
  "totalEvents": 15420,
  "byAction": {
    "login": 5200,
    "collection": 8100,
    "configuration": 2120
  },
  "period": "last-30-days"
}