Statistiques
Endpoints de lecture pour l’analytique des clics et UTM.
GET /stats/{scope_id}/breakdown
Ventilation selon une dimension
Distribution d’une métrique choisie selon une `dimension` : valeurs top-N et ligne de queue `(other)` optionnelle. Une requête par graphique du tableau de bord.
Comportement
Paramètres de chemin
Paramètres de requête
Réponses
GET /stats/{scope_id}/geo
Carte géo des clics (pays / régions / hex)
Choroplèthe par pays (`mode=countries`), régions (`mode=regions&country=RU`) ou heatmap hex (`mode=hex`). Hex nécessite la rétention raw. Countries/regions fonctionnent depuis agg (`clicks_by_country` / `clicks_by_region`). `items[].key` est un code ISO pour le matching carte ; `items[].label` est le nom complet lisible selon `Accept-Language` (`ru`/`en`/`de`/`fr` ; pas une abréviation ni une IP).
Paramètres de chemin
Paramètres de requête
Réponses
GET /stats/{scope_id}/overview
Overview scope/folder/short
Résumé des clics pour un scope, un dossier ou un lien : KPI, courte série quotidienne, ventilations top-N et (pour scope/dossier) meilleurs liens. Une requête à l’ouverture de l’écran ou au rafraîchissement manuel — **pas** pour le polling.
Comportement
Paramètres de chemin
Paramètres de requête
Réponses
GET /stats/{scope_id}/ranking
Top entités dans l’entity
Tableau top ordonné pour la fenêtre sélectionnée : liens, targets, campagnes UTM, referrers, pays, etc. Adapté aux tableaux de bord et au polling ~60 s.
Comportement
Paramètres de chemin
Paramètres de requête
Réponses
GET /stats/{scope_id}/series
Série temporelle pour le polling
Série temporelle de métriques `(t, metrics…)` à la granularité `hour` ou `day`. Conçue pour le **polling** du tableau de bord (intervalle recommandé — au plus une fois par minute).
Comportement
Paramètres de chemin
Paramètres de requête
Réponses
GET /stats/{scope_id}/shorts/{short_id}
Fiche de lien court : lifetime + window
Fiche détaillée pour un lien : métriques **lifetime** (toujours disponibles, y compris après purge des clics détaillés) et KPI de fenêtre avec série quotidienne et ventilations optionnelles.
Comportement
Paramètres de chemin
Paramètres de requête