Statistik
Lese-Endpunkte für Klick- und UTM-Analysen.
GET /stats/{scope_id}/breakdown
Aufschlüsselung nach einer Dimension
Verteilung einer gewählten Metrik nach einer `dimension`: Top-N-Werte und optionale `(other)`-Restzeile. Eine Anfrage pro Dashboard-Diagramm.
Verhalten
Pfadparameter
Query-Parameter
Antworten
GET /stats/{scope_id}/geo
Klick-Geokarte (Länder / Regionen / Hex)
Choropleth nach Land (`mode=countries`), Regionen (`mode=regions&country=RU`) oder Hex-Heatmap (`mode=hex`). Hex benötigt raw-Retention. Countries/regions funktionieren aus agg (`clicks_by_country` / `clicks_by_region`). `items[].key` ist ein ISO-Code für Map-Matching; `items[].label` ist der vollständige menschenlesbare Name laut `Accept-Language` (`ru`/`en`/`de`/`fr`; keine Abkürzung und keine IP).
Pfadparameter
Query-Parameter
Antworten
GET /stats/{scope_id}/overview
Overview scope/folder/short
Klick-Zusammenfassung für Scope, Ordner oder einzelnen Link: KPIs, kurze Tagesreihe, Top-N-Aufschlüsselungen und (für Scope/Ordner) Top-Links. Eine Anfrage beim Öffnen des Bildschirms oder bei manuellem Refresh — **nicht** für Polling.
Verhalten
Pfadparameter
Query-Parameter
Antworten
GET /stats/{scope_id}/ranking
Top-Entitäten innerhalb der Entity
Sortierte Top-Tabelle für das gewählte Fenster: Links, Targets, UTM-Kampagnen, Referrer, Länder usw. Geeignet für Dashboard-Tabellen und ~60s-Polling.
Verhalten
Pfadparameter
Query-Parameter
Antworten
GET /stats/{scope_id}/series
Zeitreihe für Polling
Zeitreihe von Metriken `(t, metrics…)` mit Granularität `hour` oder `day`. Für Dashboard-**Polling** gebaut (empfohlenes Intervall — höchstens einmal pro Minute).
Verhalten
Pfadparameter
Query-Parameter
Antworten
GET /stats/{scope_id}/shorts/{short_id}
Kurzlink-Karte: lifetime + window
Detaillierte Karte für einen Link: **lifetime**-Metriken (immer verfügbar, auch nachdem detaillierte Klicks gelöscht wurden) und Fenster-KPIs mit optionaler Tagesreihe und Aufschlüsselungen.
Verhalten
Pfadparameter
Query-Parameter