Passer au contenu principal
GET
curl
La Business Console affiche les mêmes chiffres au-dessus de la liste des événements. Consultez Enrichissement IP dans le guide d’ingestion des événements pour comprendre pourquoi la télémétrie à faible valeur ne consulte l’enrichissement que lorsqu’un autre événement a déjà résolu l’adresse, et Enrichissement IP pour les champs associés à une adresse enrichie.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de requête

days
integer
défaut:30

Durée de la période en jours. Vaut 30 par défaut ; les valeurs sont limitées entre 1 et 365, et une valeur non entière revient à 30. La valeur appliquée est renvoyée sous la forme period_days.

Plage requise: 1 <= x <= 365

Réponse

Compteurs et ratios pour la période.

events_ingested
integer
requis

Nouveaux événements enregistrés. Les rejouements idempotents ne sont pas comptabilisés.

events_rejected
integer
requis

Éléments rejetés dans les requêtes par lots (flux serveur et appareil). Une requête d'événement unique rejetée n'est pas comptabilisée.

enrichment_lookups
integer
requis

Événements dont l'adresse IP publique a été résolue, depuis le cache ou récemment.

enrichment_cache_hits
integer
requis

Recherches servies depuis le cache.

enrichment_provider_calls
integer
requis

Recherches ayant nécessité une nouvelle résolution de l'adresse.

enrichment_skipped_low_value
integer
requis

Événements de télémétrie de faible valeur dont l'adresse n'était pas déjà connue. Ils ne déclenchent jamais de nouvelle résolution qui leur soit propre.

unique_ips_seen
integer
requis

Adresses nécessitant une nouvelle résolution.

period_days
integer
requis

La valeur days appliquée après limitation aux bornes autorisées.

cache_hit_rate
number | null
requis

enrichment_cache_hits / enrichment_lookups, arrondi à 4 décimales. Null lorsqu'il n'y a eu aucune recherche.

unique_ip_ratio
number | null
requis

unique_ips_seen / events_ingested, arrondi à 4 décimales. Null lorsqu'aucun événement n'a été ingéré.

provider_calls_per_1k_events
number | null
requis

Résolutions fraîches pour 1000 événements ingérés, arrondies à 2 décimales. Null si aucun événement n'a été ingéré.

Dernière modification le 7 novembre 2026