Zum Hauptinhalt springen
POST
Risikoereignis-Export erstellen
Ein Objekt wie { "format": "json", "event_types": ["signal", "decision"] } übermitteln. export_id speichern und den Lese-Endpunkt abfragen. Eine 202-Antwort bestätigt, dass der Job existiert; sie bestätigt nicht, dass die Verarbeitung abgeschlossen ist. Risikoexporte enthalten Risikosignale und Entscheidungen des Arbeitsbereichs. Sie konfigurieren keine automatische Weiterleitung von Audit-Protokollen. Siehe SIEM-Integration für den Unterschied.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

application/json
format
enum<string>
Standard:json
Verfügbare Optionen:
json,
csv,
cef,
leef
event_types
enum<string>[]

Aufzuzeichnende Kategorien. Leer oder weggelassen schließt beides ein; dies sind keine Anbieternamen oder Risikosignal-Untertypen.

Maximum array length: 2
Verfügbare Optionen:
signal,
decision
since
string<date-time>

Inklusive Untergrenze. Standardmäßig 30 Tage vor bis.

until
string<date-time>

Exklusive Obergrenze. Standardmäßig auf die Anfragezeit eingestellt. Maximaler Bereich: 366 Tage; zukünftige Bereiche werden abgelehnt.

Antwort

Job gespeichert; export_id abfragen

export_id
string<uuid>
status
enum<string>
Verfügbare Optionen:
pending,
running,
complete,
failed
format
enum<string>
Verfügbare Optionen:
json,
csv,
cef,
leef
since
string<date-time>
until
string<date-time>
event_types
enum<string>[]
Verfügbare Optionen:
signal,
decision
record_count
integer
created_at
string<date-time>
completed_at
string<date-time>
error_message
string
export_data

Geparsedte JSON-Beweise für das JSON-Format; Text für CSV, CEF und LEEF. Nur vorhanden, wenn vollständig.