Vai al contenuto principale
GET
curl
Consulta Evidenza per sapere come le esecuzioni delle regole registrano ogni valore corrispondente e la sua origine, e Arricchimento IP per i campi dell’indirizzo IP arricchiti.

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.

Parametri del percorso

event_uuid
string<uuid>
obbligatorio

Identificatore Didit dell'evento (event_uuid dalla risposta di creazione, batch, elenco o timeline), non il tuo event_id.

Risposta

L'evento con le relative prove.

Un evento di monitoraggio con la sua busta completa, l'arricchimento e le evidenze delle regole. Tutti i campi di MonitoringEvent più i campi seguenti.

event_uuid
string<uuid>
obbligatorio

Identificatore Didit dell'evento. Utilizzalo come {event_uuid} nelle chiamate di recupero e cancellazione.

event_id
string
obbligatorio

Il tuo identificatore, la chiave di idempotenza che hai inviato.

Maximum string length: 128
event_category
enum<string>
obbligatorio

Categoria dell'evento.

Opzioni disponibili:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
action_type
string
obbligatorio

Cosa è successo all'interno della categoria, così come l'hai inviato.

Maximum string length: 128
occurred_at
string<date-time>
obbligatorio

Data e ora in cui l'evento si è verificato nel tuo sistema.

received_at
string<date-time>
obbligatorio

Quando Didit ha accettato l'evento.

status
enum<string>
obbligatorio

ACCEPTED: memorizzato, nessuna regola corrispondente ha modificato il suo stato (la risposta normale per la maggior parte degli eventi, e sempre la risposta in un'applicazione sandbox, dove non viene eseguita alcuna regola). APPROVED: una regola ha trovato corrispondenza e il punteggio è rimasto al di sotto della soglia di revisione. IN_REVIEW: una regola ha fatto superare al punteggio la soglia di revisione o ha impostato lo stato. DECLINED: una regola lo ha rifiutato o il punteggio ha superato la soglia di rifiuto.

Opzioni disponibili:
ACCEPTED,
APPROVED,
IN_REVIEW,
DECLINED
score
integer
obbligatorio

Punteggio cumulativo delle regole. Inizia da 0; le azioni add_score delle regole lo modificano (sono consentiti delta negativi).

subject_vendor_data
string
obbligatorio

subject.vendor_data dell'evento: il tuo identificativo per l'utente o l'azienda.

Maximum string length: 255
subject_entity_type
string
obbligatorio

individual o company: indica il tipo di soggetto a cui fa riferimento subject_vendor_data.

Esempio:

"individual"

subject_uuid
string<uuid> | null
obbligatorio

UUID dell'utente (persona fisica) o dell'azienda a cui l'evento è stato ricondotto, oppure null se tale record non esiste più.

counterparty_vendor_data
string | null
obbligatorio

L'altro partecipante di un evento P2P (promosso da payload.counterparty_vendor_data).

Maximum string length: 255
session_id
string | null
obbligatorio

session.session_id inviato con l'evento.

Maximum string length: 255
device_fingerprint
string | null
obbligatorio

device_context.fingerprint inviato con l'evento.

Maximum string length: 255
ip_address
string | null
obbligatorio

Indirizzo IP dell'evento. Sul lato server è device_context.network_context.ip_address come lo hai inviato; sul lato dispositivo è l'IP della richiesta.

Maximum string length: 64
ip_country
string | null
obbligatorio

Codice del paese di ip_address ottenuto dall'arricchimento IP, oppure null quando l'indirizzo non è stato arricchito (telemetria mancante, privata o a basso valore il cui indirizzo non era già noto).

Esempio:

"ES"

amount
string | null
obbligatorio

Importo come stringa decimale con 18 cifre decimali, da transaction_context.amount, payload.amount o payload.stake_amount, in quest'ordine.

Esempio:

"250.000000000000000000"

currency
string | null
obbligatorio

Valuta da transaction_context.currency o payload.currency.

Maximum string length: 10
game_id
string | null
obbligatorio

Promosso da payload.game_id.

Maximum string length: 128
round_id
string | null
obbligatorio

Promosso da payload.round_id.

Maximum string length: 128
bonus_id
string | null
obbligatorio

Promosso da payload.bonus_id.

Maximum string length: 128
affiliate_code
string | null
obbligatorio

Promosso da payload.affiliate_code.

Maximum string length: 128
payment_reference_id
string | null
obbligatorio

Riferimento di pagamento da transaction_context.payment_reference_id o payload.payment_reference_id.

Maximum string length: 255
retention_class
enum<string>
obbligatorio

Classe di conservazione. Gli eventi di pagamento e contestazione sono monetary_or_compliance; gli eventi di sicurezza e gioco responsabile sono risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed e affiliate.referral_clicked sono low_value; tutto il resto è standard. Un evento corrispondente a una regola attiva viene promosso a risk_relevant (senza mai essere retrocesso).

Opzioni disponibili:
low_value,
standard,
risk_relevant,
monetary_or_compliance
rules_matched_count
integer
obbligatorio

Numero di regole che hanno corrisposto all'evento, incluse le regole in modalità TEST (che registrano le prove ma non applicano azioni).

Intervallo richiesto: x >= 0
correlation_pending
boolean
obbligatorio

true mentre una regola asincrona (correlazione tra soggetti o una sequenza superiore a 24 ore) deve ancora essere eseguita per questo evento. Si risolve entro pochi minuti e status, score e rules_matched_count vengono aggiornati sul posto.

is_droppable
boolean
obbligatorio

Indica se un SDK sotto contropressione (backpressure) può ignorare eventi di questo tipo. false per ogni evento di security, payment, dispute e responsible_gambling e per gameplay.bet_placed, gameplay.bet_settled e gameplay.p2p_settlement.

payload
object
obbligatorio

I campi della categoria inviati in payload.

custom_values
object
obbligatorio

I valori scalari di custom_values che hai inviato. Didit aggiunge vpn_or_proxy_detected: true o is_data_center: true quando l'arricchimento IP contrassegna l'indirizzo e non li hai impostati.

device_context
object
obbligatorio

Il contesto del dispositivo archiviato: il tuo device_context (inclusi fingerprint, persistent_device_id e bot_score se inviati) con network_context completato tramite arricchimento IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) per le chiavi lasciate vuote.

field_sources
object
obbligatorio

Percorso del campo della provenienza: customer (inviato dal tuo backend), sdk (inviato tramite il canale del dispositivo) o server (derivato da Didit, come received_at e i campi di rete arricchiti). Verificalo prima di intervenire su una corrispondenza.

session_sequence
integer<int64> | null
obbligatorio

session.sequence inviato con l'evento.

table_id
string | null
obbligatorio

Promosso da payload.table_id.

Maximum string length: 128
hand_id
string | null
obbligatorio

Promosso da payload.hand_id.

Maximum string length: 128
match_id
string | null
obbligatorio

Promosso da payload.match_id.

Maximum string length: 128
market_id
string | null
obbligatorio

Promosso da payload.market_id.

Maximum string length: 128
side
string | null
obbligatorio

Promosso da payload.side.

Maximum string length: 64
role
string | null
obbligatorio

Promosso da payload.role.

Maximum string length: 64
net_result_amount
string | null
obbligatorio

Promosso da payload.net_result_amount, come stringa decimale con 18 cifre decimali.

Esempio:

"-120.000000000000000000"

payment_fingerprint
string | null
obbligatorio

Promosso da payload.payment_fingerprint.

Maximum string length: 255
instrument_reference_hash
string | null
obbligatorio

Promosso da payload.instrument_reference_hash.

Maximum string length: 255
withdrawal_address_hash
string | null
obbligatorio

Promosso da payload.withdrawal_address_hash (o payload.destination_reference_hash).

Maximum string length: 255
dispute_id
string | null
obbligatorio

Promosso da payload.dispute_id.

Maximum string length: 255
chargeback_id
string | null
obbligatorio

Promosso da payload.chargeback_id.

Maximum string length: 255
changed_field
string | null
obbligatorio

Promosso da payload.changed_field (eventi di modifica della sicurezza).

Maximum string length: 128
identity_match_ref
string | null
obbligatorio

Promosso da payload.identity_match_ref (corrispondenze nel registro del gioco responsabile).

Maximum string length: 255
schema_version
integer
obbligatorio

Versione dello schema dell'involucro dell'evento. Attualmente 1.

Esempio:

1

expires_at
string<date-time> | null
obbligatorio

Data e ora di scadenza ed eliminazione dell'evento in base alla relativa classe di conservazione: occurred_at più il periodo della classe (14, 30 o 90 giorni per impostazione predefinita, modificabile per applicazione). Null per gli eventi monetary_or_compliance, che seguono la conservazione delle transazioni.

rules_evaluated_count
integer
obbligatorio

Numero di regole di evento valutate per questo evento.

Intervallo richiesto: x >= 0
rule_runs
object[]
obbligatorio

Ogni regola che ha trovato corrispondenza con l'evento, dalla più recente alla più vecchia.

ip_enrichment
object | null
obbligatorio

Arricchimento dell'indirizzo IP dell'evento, oppure null se l'indirizzo non è stato arricchito. Consulta arricchimento IP.

subject_profile
object | null
obbligatorio

Segnali di rischio memorizzati nella cache per email e telefono del soggetto, oppure null se non esiste alcun profilo per il soggetto.

tags
string[]
obbligatorio

Nomi dei tag associati all'evento (azioni add_tags della regola).

Ultima modifica il 7 novembre 2026