Vai al contenuto principale
GET
curl
Gli eventi sono archiviati in classi di conservazione, quindi un evento dopo la scadenza del periodo di conservazione previsto dalla propria classe non compare più qui. Consulta Acquisizione degli eventi per il riferimento dei filtri e Regole sugli eventi per capire cosa fa variare rules_matched_count.

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 della query

limit
integer
predefinito:50

Numero massimo di eventi per pagina. Il valore predefinito è 50. I valori superiori a 1000000 restituiscono 400; un valore non numerico, pari a zero o negativo viene reimpostato su 50.

Intervallo richiesto: 1 <= x <= 1000000
offset
integer
predefinito:0

Numero di eventi da saltare. Il valore predefinito è 0. È preferibile seguire l'URL next della risposta.

Intervallo richiesto: 0 <= x <= 1000000
event_category
enum<string>[]

Solo gli eventi in queste categorie. Ripeti il parametro per più valori (?event_category=payment&event_category=dispute); viene restituito un evento corrispondente a uno qualsiasi di essi.

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

Solo gli eventi con questi tipi di azione (esatti, con distinzione tra maiuscole e minuscole). Ripeti per più valori.

status
enum<string>[]

Solo gli eventi con questi stati. Ripeti per più valori.

Opzioni disponibili:
ACCEPTED,
APPROVED,
IN_REVIEW,
DECLINED
retention_class
enum<string>[]

Solo gli eventi in queste classi di conservazione. Ripeti per più valori.

Opzioni disponibili:
low_value,
standard,
risk_relevant,
monetary_or_compliance
subject_vendor_data
string

Corrispondenza esatta sul vendor_data del soggetto. Lo stesso ID può identificare sia una persona fisica che un'azienda; aggiungi subject_entity_type per sceglierne uno, oppure usa GET /v3/events/subjects/{vendor_data}/.

subject_entity_type
enum<string>

company restituisce solo gli eventi dei soggetti aziendali; qualsiasi altro valore non vuoto (ad esempio individual) restituisce solo gli eventi delle persone fisiche. Omettilo per restituire entrambi.

Opzioni disponibili:
individual,
company
business_vendor_data
string

Corrispondenza esatta sul business.vendor_data inviato con l'evento.

session_id
string

Corrispondenza esatta su session.session_id.

device_fingerprint
string

Corrispondenza esatta su device_context.fingerprint.

ip_address
string

Corrispondenza esatta sull'indirizzo IP dell'evento.

game_id
string

Corrispondenza esatta su game_id promosso.

round_id
string

Corrispondenza esatta su round_id promosso.

affiliate_code
string

Corrispondenza esatta su affiliate_code promosso.

payment_reference_id
string

Corrispondenza esatta sul riferimento di pagamento (da transaction_context.payment_reference_id o payload.payment_reference_id).

counterparty_vendor_data
string

Corrispondenza esatta su counterparty_vendor_data promosso.

matched_only
boolean
predefinito:false

true (anche 1 o yes, senza distinzione tra maiuscole e minuscole) restituisce solo gli eventi a cui corrisponde almeno una regola (rules_matched_count maggiore di 0). Qualsiasi altro valore viene ignorato.

occurred_from
string<date-time>

Solo gli eventi con occurred_at pari o successivo a questo istante (incluso). Invia un valore ISO 8601: 2026-10-01T00:00:00Z, un offset esplicito con il + codificato in percentuale (2026-10-01T02:00:00%2B02:00; un + non codificato viene decodificato come spazio e il valore non risulta più analizzabile), oppure solo una data (2026-10-01), che indica le 00:00:00 UTC di quel giorno. Un valore privo di offset viene interpretato come UTC. I valori in qualsiasi altro formato non sono accettati.

occurred_to
string<date-time>

Solo gli eventi con occurred_at pari o antecedente a questo istante (incluso). Una data da sola indica l'inizio di quel giorno, quindi occurred_to=2026-10-15 esclude il resto del 15 ottobre; invia 2026-10-15T23:59:59Z per includerlo. Invia un valore ISO 8601: 2026-10-01T00:00:00Z, un offset esplicito con il + codificato in percentuale (2026-10-01T02:00:00%2B02:00; un + non codificato viene decodificato come spazio e il valore non risulta più analizzabile), oppure solo una data (2026-10-01), che indica le 00:00:00 UTC di quel giorno. Un valore privo di offset viene interpretato come UTC. I valori in qualsiasi altro formato non sono accettati.

Corrispondenza di sottostringhe senza distinzione tra maiuscole e minuscole su event_id, action_type, subject_vendor_data o counterparty_vendor_data.

Risposta

Una pagina di riepiloghi degli eventi.

Una pagina di eventi di monitoraggio, con il valore di occurred_at più recente per primo.

count
integer
obbligatorio

Numero di eventi corrispondenti, esatto fino a 100 e con limite massimo di 100 oltre tale soglia. Non calcolare il conteggio delle pagine da questo valore; segui next finché non è null.

next
string<uri> | null
obbligatorio

URL della pagina successiva, o null nell'ultima pagina.

previous
string<uri> | null
obbligatorio

URL della pagina precedente, o null nella prima pagina.

results
object[]
obbligatorio
Ultima modifica il 7 novembre 2026