Vai al contenuto principale
GET
curl
La Business Console mostra gli stessi numeri sopra l’elenco degli eventi. Consulta arricchimento IP nella guida all’ingestione degli eventi per capire perché la telemetria a basso valore viene arricchita solo quando un altro evento ha già risolto l’indirizzo, e arricchimento IP per i campi di un indirizzo arricchito.

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

days
integer
predefinito:30

Durata del periodo in giorni. Il valore predefinito è 30; i valori sono limitati all'intervallo compreso tra 1 e 365, e un valore non intero torna a 30. Il valore applicato viene restituito come period_days.

Intervallo richiesto: 1 <= x <= 365

Risposta

Contatori e rapporti per il periodo.

events_ingested
integer
obbligatorio

Nuovi eventi memorizzati. I replay idempotenti non vengono conteggiati.

events_rejected
integer
obbligatorio

Elementi rifiutati all'interno di richieste in batch (lato server e lato dispositivo). Una richiesta per evento singolo rifiutata non viene conteggiata.

enrichment_lookups
integer
obbligatorio

Eventi il cui indirizzo IP pubblico è stato risolto, dalla cache o ex novo.

enrichment_cache_hits
integer
obbligatorio

Ricerche risposte dalla cache.

enrichment_provider_calls
integer
obbligatorio

Ricerche che hanno richiesto una nuova risoluzione dell'indirizzo.

enrichment_skipped_low_value
integer
obbligatorio

Eventi di telemetria di basso valore il cui indirizzo non era già noto. Non attivano mai una nuova risoluzione autonoma.

unique_ips_seen
integer
obbligatorio

Indirizzi che richiedevano una nuova risoluzione.

period_days
integer
obbligatorio

Il valore days applicato dopo l'applicazione dei limiti.

cache_hit_rate
number | null
obbligatorio

enrichment_cache_hits / enrichment_lookups, arrotondato a 4 decimali. Null quando non ci sono state ricerche.

unique_ip_ratio
number | null
obbligatorio

unique_ips_seen / events_ingested, arrotondato a 4 decimali. Null quando non è stato acquisito alcun evento.

provider_calls_per_1k_events
number | null
obbligatorio

Risoluzioni recenti per 1000 eventi acquisiti, arrotondate a 2 decimali. Null se non è stato acquisito alcun evento.

Ultima modifica il 7 novembre 2026