API timeline della rete di frodi

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

Recupera la cronologia degli eventi di una rete. Senza contract, la risposta contiene la cronologia della rete stessa, dal più vecchio al più recente e senza paginazione: quando è stata rilevata per la prima volta, quando ciascun segnale è stato osservato l’ultima volta e la sua ultima variazione di stato con il relativo motivo. Questa struttura non cambia e limit, cursor ed event_type vengono ignorati.

Cronologia tipizzata

Passa contract=2 per leggere invece la cronologia tipizzata. Aggiunge le azioni degli account dei membri e le azioni del tuo team sulla rete, dal più recente al più vecchio, una pagina alla volta. contract accetta solo 2; qualsiasi altro valore restituisce 400.

Parametro	Significato
`limit`	Eventi per pagina, da 1 a 500. Il valore predefinito è 100.
`cursor`	Il `next_cursor` della pagina precedente. Un cursore non valido o vuoto restituisce `400`.
`event_type`	I tipi di evento da mantenere, ripetuti o separati da virgole, al massimo 20 valori. Per impostazione predefinita, include tutti i tipi.

La risposta è {"results": [...], "next_cursor": "..."}. Leggi la pagina successiva impostando cursor su next_cursor, finché next_cursor non è null.

Tipi di evento

`event_type`	Cosa registra	Blocco di dettaglio
`network_detected`	La rete è stata rilevata	Nessuno
`signal_observed`	L’ultima osservazione di un segnale	Nessuno
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	L’ultima variazione di stato della rete, con il motivo in `metadata`	Nessuno
`verification_attempt`	Una sessione di verifica di un membro (una persona o un’azienda), numerata (`attempt` di `attempt_count`), con i motivi del rifiuto quando è rifiutata	`verification_attempt`
`transaction`	Una transazione a cui ha partecipato un membro, datata con la data della transazione	`transaction`
`login`	Un accesso o un tentativo di accesso non riuscito che hai inviato per un membro tramite l’API degli eventi	`login`
`rule_hit`	Una regola attiva che ha rilevato una corrispondenza con la transazione o l’evento di un membro	`rule_hit`
`case_linked`	Un caso aperto per la rete nella tua organizzazione	`case_linked`
`note_added`	Una nota lasciata sulla rete, senza il suo testo	`note_added`

Gli eventi note_added vengono restituiti solo ai membri della console, mai a una chiave API. Una transazione tra due membri compare una volta per ciascuno di loro, ognuna con il proprio account. Una corrispondenza di regola relativa a quella transazione compare una sola volta. Gli eventi di accesso esistono solo per gli accessi che invii come eventi: auth.login, security.login_succeeded e le loro forme non riuscite.

Account e record

Ogni evento di un membro contiene account, il membro a cui appartiene, e source_ref, la sessione, la sessione aziendale, la transazione, l’evento di monitoraggio o il caso da cui è stato letto. ownership vale owned quando il record appartiene all’applicazione che hai chiamato, e organization quando appartiene a un’altra applicazione della tua organizzazione. route indica il tipo di record, il suo UUID e l’applicazione; source_ref non ha route per un evento di monitoraggio o per un caso. Gli eventi propri della rete non contengono né account né source_ref.

Correlati

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

organization_id

string<uuid>

obbligatorio

UUID dell'organizzazione.

application_id

string<uuid>

obbligatorio

UUID dell'applicazione.

network_uuid

string<uuid>

obbligatorio

UUID della rete.

Esempio:

"n3a5e000-0000-4000-8000-000000000001"

Parametri della query

contract

enum<string>

2 restituisce la cronologia tipizzata. Omettilo per la cronologia predefinita. Qualsiasi altro valore restituisce 400.

Opzioni disponibili:

2

limit

integer

predefinito:100

Solo cronologia con tipizzazione. Eventi per pagina, da 1 a 500. Il valore predefinito è 100.

Intervallo richiesto: 1 <= x <= 500

cursor

string

Solo cronologia con tipizzazione. Il next_cursor della pagina precedente. Un cursore non valido o vuoto restituisce 400.

event_type

enum<string>[]

Solo cronologia con tipizzazione. Tipi di eventi da conservare, ripetuti o separati da virgola, massimo 20 valori. Il valore predefinito include tutti i tipi.

Maximum array length: 20

Opzioni disponibili:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Risposta

Senza contract: {results}, i meno recenti per primi, non impaginati. Con contract=2: {results, next_cursor}, i più recenti per primi.

Default timeline (no contract)
Typed timeline page (contract=2)

Senza contract: gli eventi della rete stessa, dal più vecchio al più recente, non impaginati.

results

object[]

Show child attributes

Ultima modifica il 7 novembre 2026

​Cronologia tipizzata

​Tipi di evento

​Account e record

​Correlati

Autorizzazioni

Parametri del percorso

Parametri della query

Risposta

Cronologia tipizzata

Tipi di evento

Account e record

Correlati