Zum Hauptinhalt springen
PATCH
curl

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

rule_uuid
string<uuid>
erforderlich

Die UUID der Regel aus der Auflistung oder Erstellung.

Body

application/json

Partielle Aktualisierung. Benutzerdefinierte Regeln akzeptieren jedes Feld; Bibliotheksregeln (PRESET) akzeptieren nur mode - alles andere gibt 400 zurück.

title
string

Regelname. Eindeutig pro Anwendung unter nicht gelöschten Regeln; Duplikate geben 400 zurück.

description
string | null
category
string

Risikothema zur Gruppierung und Berichterstellung, z. B. finance, aml_ctf, anomaly_detection, fatf, device_intelligence, crypto_monitoring, travel_rule, responsible_gaming, e_commerce.

mode
enum<string>

ACTIVE wertet live aus. TEST wertet Regelläufe aus und zeichnet sie auf, ändert jedoch niemals Score oder Status – der empfohlene Startmodus. DISABLED wird übersprungen.

Verfügbare Optionen:
ACTIVE,
DISABLED,
TEST
evaluation_mode
enum<string>
Standard:ALL

Gibt an, ob jede Bedingung zutreffen muss (ALL) oder mindestens eine (ANY). Wird ignoriert, wenn Bedingungen group_index verwenden.

Verfügbare Optionen:
ALL,
ANY
scope
object

Für welche Transaktionen die Regel gilt. Es werden nur diese drei Schlüssel akzeptiert.

conditions
object[]
aggregation
object[]
actions
object[]

Eine Regelaktion. Eine Regel kann mehrere enthalten; alle werden zusammen angewendet, wenn sie zutrifft. Regeln im TEST-Modus zeichnen auf, was sie getan hätten, ohne eine Aktion anzuwenden.

metadata
object

Freiform-Metadaten, die für die Regel gespeichert sind.

Antwort

Die aktualisierte Regel.

uuid
string<uuid>
title
string

Regelname. Eindeutig pro Anwendung unter nicht gelöschten Regeln; Duplikate geben 400 zurück.

description
string | null
category
string

Risikothema zur Gruppierung und Berichterstellung, z. B. finance, aml_ctf, anomaly_detection, fatf, device_intelligence, crypto_monitoring, travel_rule, responsible_gaming, e_commerce.

mode
enum<string>

ACTIVE wertet live aus. TEST wertet Regelläufe aus und zeichnet sie auf, ändert jedoch niemals Score oder Status – der empfohlene Startmodus. DISABLED wird übersprungen.

Verfügbare Optionen:
ACTIVE,
DISABLED,
TEST
evaluation_mode
enum<string>
Standard:ALL

Gibt an, ob jede Bedingung zutreffen muss (ALL) oder mindestens eine (ANY). Wird ignoriert, wenn Bedingungen group_index verwenden.

Verfügbare Optionen:
ALL,
ANY
scope
object

Für welche Transaktionen die Regel gilt. Es werden nur diese drei Schlüssel akzeptiert.

conditions
object[]
aggregation
object[]
actions
object[]

Eine Regelaktion. Eine Regel kann mehrere enthalten; alle werden zusammen angewendet, wenn sie zutrifft. Regeln im TEST-Modus zeichnen auf, was sie getan hätten, ohne eine Aktion anzuwenden.

metadata
object

Freiform-Metadaten, die für die Regel gespeichert sind.

severity
enum<string> | null

Informativer Schweregrad, der von Bibliotheksregeln getragen wird; kann bei benutzerdefinierten Regeln nicht festgelegt werden.

Verfügbare Optionen:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
source
enum<string>

PRESET-Regeln stammen aus der Bibliothek (Installieren/Deinstallieren, Bearbeitungen nur des Modus); CUSTOM-Regeln gehören vollständig Ihnen.

Verfügbare Optionen:
PRESET,
CUSTOM
library_key
string | null

Stabile Bibliothekskennung; null für benutzerdefinierte Regeln.

latest_triggered_at
string<date-time> | null
run_count
integer

Wie viele Transaktionen mit dieser Regel übereingestimmt haben.

approved_count
integer
reviewed_count
integer
declined_count
integer
awaiting_user_count
integer
approved_pct
number
reviewed_pct
number
declined_pct
number
created_at
string<date-time>
updated_at
string<date-time>
Zuletzt geändert am 7. November 2026