curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
Benutzerprotokolle & Aktivität
Export von Benutzeraktivitätsprotokollen auslösen
POST /user-logs/export/
POST
/
user-logs
/
export
/
curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
Stellt einen asynchronen Job in die Warteschlange, der eine CSV-Datei der Kontoaktivität (Erstellungs-/Aktualisierungs-/Löschereignisse, Anmeldungen und Freigaben) für einen Zeitraum erzeugt, auf dem Management-API-Host (
Der Aufruf gibt sofort
api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
POST https://api.scanova.io/user-logs/export/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
Beginn des Exportzeitraums, als
DD/MM/YYYY HH:MM (24-Stunden-Format), exklusiv.string
Ende des Exportzeitraums, als
DD/MM/YYYY HH:MM (24-Stunden-Format), inklusive.curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
200 zurück, sobald der Job in die Warteschlange gestellt wurde — id ist die ID des Exportjobs in Verlauf der Benutzerprotokoll-Exporte auflisten, wo Sie den status abfragen. Das Konto erhält eine E-Mail, wenn der Export abgeschlossen ist oder fehlschlägt.
fromDate/toDate werden nicht synchron validiert. Ein fehlerhafter Datumsstring führt hier nicht zu einem 400 — der Job wird erstellt und schlägt erst asynchron fehl, sobald der Worker versucht, ihn zu parsen, was zu status: "failed" und einer Fehler-E-Mail führt. Prüfen Sie das Format DD/MM/YYYY HH:MM immer vor dem Senden.403, wenn der Plan des Kontos nicht über die Quota USER_LOGS_EXPORT verfügt oder wenn ein aufrufender geteilter Benutzer nicht über die Berechtigung SHARED_USER_CAN_EXPORT_USER_LOGS verfügt:
403
{ "detail": "Your plan does not have user logs quota." }
Abgeschlossene Exportdatensätze und ihre CSV-Dateien werden 14 Tage lang aufbewahrt und danach automatisch gelöscht.
Verwandte Themen
- Verlauf der Benutzerprotokoll-Exporte auflisten — den Job-Status abfragen.
- Exportverlaufseintrag löschen — einen Job vorzeitig entfernen.
- Übersicht über die Management API — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.
Autorisierungen
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Antwort
200 - application/json
Export job queued.
War diese Seite hilfreich?