Saltar al contenido principal
GET
curl
La Business Console muestra las mismas cifras encima de la lista de eventos. Consulta Enriquecimiento de IP en la guía de ingesta de eventos para saber por qué la telemetría de bajo valor solo consulta el enriquecimiento cuando otro evento ya ha resuelto la dirección, y Enriquecimiento de IP para ver los campos que incluye una dirección enriquecida.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de consulta

days
integer
predeterminado:30

Duración del periodo en días. El valor predeterminado es 30; los valores se limitan al rango de 1 a 365 y un valor no entero se sustituye por 30. El valor aplicado se devuelve como period_days.

Rango requerido: 1 <= x <= 365

Respuesta

Contadores y ratios del período.

events_ingested
integer
requerido

Nuevos eventos almacenados. Las repeticiones idempotentes no se cuentan.

events_rejected
integer
requerido

Elementos rechazados dentro de solicitudes por lotes (canales de servidor y de dispositivo). Una solicitud de un solo evento rechazada no se cuenta.

enrichment_lookups
integer
requerido

Eventos cuya dirección IP pública se resolvió, desde la caché o con una consulta nueva.

enrichment_cache_hits
integer
requerido

Consultas respondidas desde la caché.

enrichment_provider_calls
integer
requerido

Consultas que requirieron una nueva resolución de la dirección.

enrichment_skipped_low_value
integer
requerido

Eventos de telemetría de poco valor cuya dirección aún no se conocía. Nunca provocan por sí mismos una nueva resolución.

unique_ips_seen
integer
requerido

Direcciones que necesitaron una nueva resolución.

period_days
integer
requerido

El valor de days aplicado después de limitarlo al rango permitido.

cache_hit_rate
number | null
requerido

enrichment_cache_hits / enrichment_lookups, redondeado a 4 decimales. Null cuando no hubo consultas.

unique_ip_ratio
number | null
requerido

unique_ips_seen / events_ingested, redondeado a 4 decimales. Null cuando no se ingirió ningún evento.

provider_calls_per_1k_events
number | null
requerido

Resoluciones nuevas por cada 1000 eventos ingeridos, redondeadas a 2 decimales. Null cuando no se ingirió ningún evento.

Última modificación el 1 de noviembre de 2026