Zum Hauptinhalt springen
POST
Risikosignal aufnehmen

Antwort

string
UUID des erstellten Risikosignals.
integer
Der aufgenommene Risikowert (0–100).
string
ISO 8601 Zeitstempel der Aufnahme.

Autorisierungen

X-API-Key
string
header
erforderlich

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

Body

application/json
signal_source
string
erforderlich
signal_type
string
erforderlich

Klassifizierung des Risikosignals

Beispiel:

"velocity_anomaly"

subject_id
string
erforderlich
subject_type
string
erforderlich
idempotency_key
string
ip_address
string
payload
any
risk_score
integer
user_agent
string

Antwort

Risikosignal erfasst

id
string<uuid>
tenant_id
string<uuid>
source
string

Ursprung des Signals (z. B. device_fingerprint, ip_reputation, email_verification, document_analysis, behavioral)

Beispiel:

"device_fingerprint"

signal_type
string

Klassifizierung des Risikosignals

Beispiel:

"velocity_anomaly"

score
number<float>

Risikobewertung zwischen 0 (kein Risiko) und 1 (höchstes Risiko)

Erforderlicher Bereich: 0 <= x <= 1
Beispiel:

0.85

details
object

Beliebige Metadaten, die mit dem Signal verknüpft sind

Beispiel:
entity_type
enum<string>

Der Typ der Entität, auf die sich dieses Signal bezieht

Verfügbare Optionen:
user,
device,
ip,
document,
session
Beispiel:

"user"

entity_id
string

Bezeichner der zu bewertenden Entität

Beispiel:

"usr_8f14e45f"

created_at
string<date-time>