Tous vos KPI en JSON, sans jamais planter : l'API stats du dashboard (fail-open)
API JSON stats du dashboard (fail-open) une fonctionnalité du module Analytics, heatmap & tableau de bord de Clustraly. L'API JSON stats du dashboard renvoie en un seul appel les indicateurs clés de Clustraly, chaque métrique isolée pour ne jamais provoquer d'erreur 500.
Un endpoint admin unique qui expose les indicateurs de Clustraly en JSON, et qui reste debout même quand un sous-système manque à l'appel. Vous branchez vos widgets, il répond, toujours.
Tous vos indicateurs clés dans une seule réponse JSON
Vous interrogez GET /admin/api/dashboard/stats et récupérez d'un coup l'essentiel de votre CMS : contenus, médias, modération, audience et santé SEO. Plus besoin d'agréger dix requêtes côté client pour alimenter un tableau de bord.
Une seule structure, prévisible, prête à nourrir n'importe quel widget ou intégration.
- Articles, publiés, pages, médias, commentaires en attente
- Aperçu analytics sur 30 jours
- Score SEO moyen, redirections, meta manquantes
- GET /admin/api/dashboard/stats
Une table manquante dégrade la valeur, pas votre page
Chaque métrique est isolée dans son propre try/catch. Si une table attendue est absente ou indisponible (seo_meta, seo_redirects, analytics…), la valeur concernée retombe simplement à 0 au lieu de faire échouer toute la réponse.
Vous obtenez des données partielles exploitables plutôt qu'un écran cassé.
- Chaque métrique isolée dans son propre try/catch
- Valeur ramenée à 0 quand une table est absente
- Aucun 500 qui casse le widget appelant
Le JSON répond toujours, même dans le pire des cas
Au-delà des garde-fous par métrique, un try/catch externe sert de dernier filet : en cas de défaillance globale, il renvoie un objet entièrement à zéro accompagné d'un champ error, plutôt qu'une page HTML d'erreur.
Le client reçoit toujours du JSON valide et sait, grâce au champ error, que la réponse est dégradée.
- Try/catch externe en dernier recours
- Objet entièrement à zéro plutôt qu'un HTML 500
- Champ error pour signaler la dégradation
Vos écarts SEO calculés dans le même appel
La réponse embarque le score SEO moyen, le nombre de redirections et les meta manquantes. Ce dernier chiffre correspond au nombre d'articles publiés moins les entités disposant d'une meta_description non vide, borné à 0 pour ne jamais passer sous zéro.
Vous repérez d'un coup d'œil ce qui reste à optimiser.
- Score SEO moyen et nombre de redirections
- meta manquantes = publiés − meta_description remplies
- Résultat borné à 0, jamais négatif
Alimentez widgets, intégrations et supervisions
Parce que le format est stable et générique, cet endpoint sert aussi bien à peupler les blocs du tableau de bord d'accueil qu'à nourrir un dashboard sur mesure, une intégration externe ou un outil de supervision.
Vous décidez de l'usage, l'API se contente de fournir des chiffres fiables et faciles à consommer.
- Blocs d'accueil et tableaux de bord sur mesure
- Intégrations externes et outils de supervision
- Format JSON stable, facile à consommer
Conçu pour ne jamais vous laisser sans réponse
Chaque chiffre est protégé individuellement, et un dernier filet renvoie un objet neutre plutôt qu'une erreur. Vos tableaux de bord affichent des données partielles utiles au lieu d'une page cassée. L'outil propose des chiffres fiables, vous décidez ce que vous en faites.
Questions fréquentes
Quelles données renvoie l'API stats du dashboard ?
Que se passe-t-il si une table de la base est absente ?
Comment savoir si la réponse est dégradée ?
Comment est calculé le nombre de meta manquantes ?
Un endpoint qui répond, quoi qu'il arrive
L'API JSON stats du dashboard rassemble vos indicateurs clés en un seul appel et les protège un par un : une table manquante dégrade une valeur à zéro plutôt que de casser la page, et un filet de sécurité global garantit toujours un JSON exploitable. Vous branchez vos widgets et intégrations en confiance, l'API se charge de rester disponible.