Persönliche Protokolle API

Persönliche Protokolle und Prüfverlauf

Fragen Sie den für den Benutzer sichtbaren Audit-Trail ab, ohne Admin-Endpunkte zu berühren

PrimeCal stellt eine persönliche Prüfoberfläche für den angemeldeten Benutzer bereit. Diese Endpunkte bieten sowohl a filterbarer Ereignis-Feed und eine aggregierte Zusammenfassung.

JWT oder Benutzer API SchlüsselFilterbarer Audit-FeedZusammenfassungsansicht

Quelle

• Controller: backend-nestjs/src/users/users.controller.ts
• DTO: backend-nestjs/src/users/dto/personal-audit.query.dto.ts

Authentifizierung und Berechtigungen

• Beide Routen erfordern eine Authentifizierung.
• Die Ergebnisse beziehen sich auf den aktuellen Benutzer.
• Diese Seite schließt absichtlich Administrator- oder benutzerübergreifende Audit-APIs aus.

Endpunktreferenz

Methode	Pfad	Zweck	Anfrage oder Anfrage	Auth	Quelle
GET	/api/users/me/audit	Listen Sie den persönlichen Audit-Feed auf.	Abfrage: categories,outcomes,severities,actions,search,from,to,limit,offset,includeAutomation	JWT oder Benutzerschlüssel API	users/users.controller.ts
GET	/api/users/me/audit/summary	Geben Sie die aggregierte Audit-Zusammenfassung zurück.	Abfrage: identisch mit Feed-Endpunkt	JWT oder Benutzerschlüssel API	users/users.controller.ts

Abfrageform

PersonalAuditQueryDto

• categories: optionales String-Array, durch Kommas getrennte Werte werden unterstützt
• outcomes: optionales String-Array, durch Kommas getrennte Werte werden unterstützt
• severities: optionales String-Array, durch Kommas getrennte Werte werden unterstützt
• actions: optionales String-Array, durch Kommas getrennte Werte werden unterstützt
• search: optionale Zeichenfolge
• from: optionale Zeichenfolge
• to: optionale Zeichenfolge
• limit: optionaler int 1..500
• offset: optionaler int >= 0
• includeAutomation: optionaler boolescher Wert, Standard true

Beispielanrufe

Lesen Sie aktuelle Audit-Ereignisse

curl "$PRIMECAL_API/api/users/me/audit?includeAutomation=true&actions=automation.rule.execute&limit=20" \
  -H "Authorization: Bearer $TOKEN"

Lesen Sie die Zusammenfassung für einen Datumsbereich

curl "$PRIMECAL_API/api/users/me/audit/summary?from=2026-03-22T00:00:00.000Z&to=2026-03-29T23:59:59.999Z" \
  -H "Authorization: Bearer $TOKEN"

Hinweise zu Reaktion und Verhalten

• Der Zusammenfassungsendpunkt verwendet den Feed-Dienst intern wieder und gibt nur summary zurück.
• includeAutomation=true ist der Schalter, der aus der Automatisierung stammende Datensätze in den Ergebnissatz zieht.
• Array-ähnliche Filter akzeptieren durch Kommas getrennte Abfragezeichenfolgen oder wiederholte Werte.

Best Practices

• Verwenden Sie die Feed-Route für detaillierte Zeitleisten-Benutzeroberflächen und die Zusammenfassungsroute für Diagramme oder KPI-Karten.
• Halten Sie limit für interaktive Ansichten angemessen klein und blättern Sie mit offset durch den Feed.
• Koppeln Sie diese Daten mit Compliance API in den Datenschutzcenter-Erfahrungen, damit Benutzer sowohl den Verlauf als auch die Steuerelemente sehen können.