Saltar al contingut principal
GET
curl
La Business Console mostra les mateixes xifres per sobre de la llista d’esdeveniments. Consulta enriquiment d’IP a la guia d’ingestió d’esdeveniments per saber per què la telemetria de baix valor només llegeix l’enriquiment quan un altre esdeveniment ja ha resolt l’adreça, i enriquiment d’IP per als camps que conté una adreça enriquida.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de consulta

days
integer
predeterminat:30

Durada del període en dies. El valor per defecte és 30; els valors s'ajusten entre 1 i 365, i un valor no enter torna a 30. El valor aplicat es retorna com a period_days.

Rang requerit: 1 <= x <= 365

Resposta

Comptadors i ràtios per al període.

events_ingested
integer
requerit

Nous esdeveniments emmagatzemats. Les repeticions idempotents no es comptabilitzen.

events_rejected
integer
requerit

Elements rebutjats dins de sol·licituds per lots (carrils de servidor i de dispositiu). No es compta una sol·licitud d'un sol esdeveniment rebutjada.

enrichment_lookups
integer
requerit

Esdeveniments l'adreça IP pública dels quals s'ha resolt, des de la memòria cau o directament.

enrichment_cache_hits
integer
requerit

Consultes resoltes des de la memòria cau.

enrichment_provider_calls
integer
requerit

Consultes que han requerit una nova resolució de l'adreça.

enrichment_skipped_low_value
integer
requerit

Esdeveniments de telemetria de baix valor l'adreça dels quals no es coneixia prèviament. Mai desencadenen una nova resolució per si mateixos.

unique_ips_seen
integer
requerit

Adreces que requerien una nova resolució.

period_days
integer
requerit

El valor days aplicat després de l'ajust als límits.

cache_hit_rate
number | null
requerit

enrichment_cache_hits / enrichment_lookups, arrodonit a 4 decimals. Null quan no hi ha hagut consultes.

unique_ip_ratio
number | null
requerit

unique_ips_seen / events_ingested, arrodonit a 4 decimals. Nul quan no s'ha ingerit cap esdeveniment.

provider_calls_per_1k_events
number | null
requerit

Resolucions recents per cada 1000 esdeveniments ingerits, arrodonit a 2 decimals. Null si no s'ha ingerit cap esdeveniment.

Darrera modificació el 7 de novembre del 2026