Zum Hauptinhalt springen
GET
curl
Die Business Console zeigt dieselben Zahlen oberhalb der Ereignisliste an. Im Leitfaden zur Ereignisaufnahme erfahren Sie unter IP-Anreicherung, warum Telemetriedaten mit geringem Informationswert die Anreicherung nur dann auslesen, wenn ein anderes Ereignis die Adresse bereits aufgelöst hat. Welche Felder eine angereicherte Adresse enthält, steht unter IP-Anreicherung.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Abfrageparameter

days
integer
Standard:30

Länge des Zeitraums in Tagen. Standardmäßig 30; Werte werden auf 1 bis 365 begrenzt, und ein nicht-ganzzahliger Wert fällt auf 30 zurück. Der angewendete Wert wird als period_days zurückgegeben.

Erforderlicher Bereich: 1 <= x <= 365

Antwort

Zähler und Verhältnisse für den Zeitraum.

events_ingested
integer
erforderlich

Neue Ereignisse gespeichert. Idempotente Wiederholungen werden nicht gezählt.

events_rejected
integer
erforderlich

In Batch-Anfragen abgelehnte Elemente (Server- und Gerätepfade). Eine abgelehnte Einzelereignis-Anfrage wird nicht gezählt.

enrichment_lookups
integer
erforderlich

Ereignisse, deren öffentliche IP-Adresse aufgelöst wurde, aus dem Cache oder gerade erst aufgelöst.

enrichment_cache_hits
integer
erforderlich

Abfragen, die aus dem Cache beantwortet wurden.

enrichment_provider_calls
integer
erforderlich

Abfragen, die eine neue Auflösung der Adresse erforderten.

enrichment_skipped_low_value
integer
erforderlich

Telemetrie-Ereignisse mit geringem Wert, deren Adresse noch nicht bekannt war. Sie lösen niemals von sich aus eine neue Auflösung aus.

unique_ips_seen
integer
erforderlich

Adressen, die eine erneute Auflösung erforderten.

period_days
integer
erforderlich

Der nach der Begrenzung angewendete days-Wert.

cache_hit_rate
number | null
erforderlich

enrichment_cache_hits / enrichment_lookups, auf 4 Dezimalstellen gerundet. Null, wenn keine Abfragen stattgefunden haben.

unique_ip_ratio
number | null
erforderlich

unique_ips_seen / events_ingested, auf 4 Dezimalstellen gerundet. Null, wenn keine Ereignisse erfasst wurden.

provider_calls_per_1k_events
number | null
erforderlich

Neue Auflösungen pro 1000 erfasste Ereignisse, gerundet auf 2 Dezimalstellen. Null, wenn keine Ereignisse erfasst wurden.

Zuletzt geändert am 7. November 2026