Vai al contenuto principale
POST
curl

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json

Crea una regola CUSTOM. Le regole in modalità ACTIVE diventano immediatamente effettive per le nuove transazioni: creale in modalità TEST ed esegui prima il backtest.

title
string
obbligatorio

Nome della regola. Univoco per applicazione tra le regole non eliminate; i duplicati restituiscono 400.

category
string
obbligatorio

Tema di rischio utilizzato per il raggruppamento e la reportistica, ad es. finance, aml_ctf, anomaly_detection, fatf, device_intelligence, crypto_monitoring, travel_rule, responsible_gaming, e_commerce.

mode
enum<string>
obbligatorio

ACTIVE valuta in produzione. TEST valuta e registra le esecuzioni delle regole senza mai modificare punteggio o stato: è la modalità iniziale consigliata. DISABLED viene ignorato.

Opzioni disponibili:
ACTIVE,
DISABLED,
TEST
description
string | null
evaluation_mode
enum<string>
predefinito:ALL

Indica se ogni condizione deve corrispondere (ALL) o almeno una (ANY). Viene ignorato quando le condizioni utilizzano group_index.

Opzioni disponibili:
ALL,
ANY
scope
object

A quali transazioni si applica la regola. Sono accettate solo queste tre chiavi.

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

Un'azione della regola. Una regola può averne diverse; vengono tutte applicate insieme in caso di corrispondenza. Le regole in modalità TEST registrano ciò che avrebbero fatto senza applicare alcuna azione.

metadata
object

Metadati a struttura libera memorizzati sulla regola.

Risposta

La regola creata.

uuid
string<uuid>
title
string

Nome della regola. Univoco per applicazione tra le regole non eliminate; i duplicati restituiscono 400.

description
string | null
category
string

Tema di rischio utilizzato per il raggruppamento e la reportistica, ad es. finance, aml_ctf, anomaly_detection, fatf, device_intelligence, crypto_monitoring, travel_rule, responsible_gaming, e_commerce.

mode
enum<string>

ACTIVE valuta in produzione. TEST valuta e registra le esecuzioni delle regole senza mai modificare punteggio o stato: è la modalità iniziale consigliata. DISABLED viene ignorato.

Opzioni disponibili:
ACTIVE,
DISABLED,
TEST
evaluation_mode
enum<string>
predefinito:ALL

Indica se ogni condizione deve corrispondere (ALL) o almeno una (ANY). Viene ignorato quando le condizioni utilizzano group_index.

Opzioni disponibili:
ALL,
ANY
scope
object

A quali transazioni si applica la regola. Sono accettate solo queste tre chiavi.

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

Un'azione della regola. Una regola può averne diverse; vengono tutte applicate insieme in caso di corrispondenza. Le regole in modalità TEST registrano ciò che avrebbero fatto senza applicare alcuna azione.

metadata
object

Metadati a struttura libera memorizzati sulla regola.

severity
enum<string> | null

Gravità informativa applicata dalle regole di libreria; non impostabile per le regole personalizzate.

Opzioni disponibili:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
source
enum<string>

Le regole PRESET provengono dalla libreria (installazione/disinstallazione, modifiche solo alla modalità); le regole CUSTOM sono interamente tue.

Opzioni disponibili:
PRESET,
CUSTOM
library_key
string | null

Identificatore stabile di libreria; null per le regole personalizzate.

latest_triggered_at
string<date-time> | null
run_count
integer

Quante transazioni corrispondono a questa regola.

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>
Ultima modifica il 7 novembre 2026