Clustraly
Plugins & API interne

Pilotez vos contenus avec l'API JSON admin analytics, heatmap & stats dashboard

API JSON admin analytics, heatmap & stats dashboard une fonctionnalité du module Plugins & API interne de Clustraly. L'API JSON analytics de Clustraly expose pages vues, heatmap d'article et compteurs de tableau de bord via des endpoints admin sécurisés en JSON.

Pages vues, carte de chaleur d'article et compteurs de tableau de bord, servis en JSON propre depuis l'admin bornés, permissionnés et tolérants aux pannes.

Pages vues

Vos pages vues, lisibles d'un coup d'œil

Vous voyez tout de suite ce que votre audience lit vraiment. L'endpoint pages vues renvoie un aperçu synthétique, le détail jour par jour et le top 10 des contenus les plus consultés.

Vous choisissez la fenêtre d'analyse de 1 à 90 jours et AnalyticsService agrège les chiffres pour vous, sans quitter l'admin.

  • Aperçu, vues par jour et top 10 en une seule réponse
  • Fenêtre au choix, bornée de 1 à 90 jours
  • Servi par AnalyticsService, directement dans l'admin
Tableau de bord

Tout l'état du CMS en un seul appel

Vous ouvrez le tableau de bord et l'état de votre site est déjà là. Un seul appel agrège articles, publiés, pages, médias, commentaires en attente, score SEO moyen, redirections, méta manquantes et analytics.

Si une table n'est pas encore migrée, le compteur concerné affiche zéro au lieu de casser la vue : vous gardez un tableau de bord toujours affichable.

  • Compteurs articles, pages, médias et commentaires en attente
  • Score SEO moyen, redirections et méta manquantes réunis
  • Chaque compteur retombe à zéro plutôt que de planter
Heatmap d'article

La heatmap qui montre où l'attention se pose

Vous repérez où l'attention se concentre sur un article donné. La heatmap renvoie les statistiques et les zones de chaleur pour l'identifiant demandé, servies par HeatmapService.

Et si la source de données manque, l'erreur devient un JSON exploitable côté client plutôt qu'une page d'erreur illisible.

  • Stats et zones de chaleur, article par article
  • Ciblé par l'identifiant de l'article de votre choix
  • Erreur SQL convertie en JSON exploitable, jamais une page cassée
Fonctionnement

Un contrat JSON simple, des codes clairs

Vous branchez vos écrans et vos scripts sans surprise. Les trois endpoints sont de simples GET sous /admin/api, avec des réponses JSON uniformes et des codes HTTP adaptés.

Les entrées sont bornées la fenêtre days reste entre 1 et 90 pour des requêtes toujours saines et prévisibles.

  • Endpoints GET sous /admin/api, faciles à consommer
  • Réponses JSON uniformes avec codes HTTP adaptés (403, 404, 500)
  • Paramètre days borné pour des requêtes toujours saines
Sécurité & accès

Des garde-fous à chaque requête

Vous exposez vos chiffres sans ouvrir de porte. Les pages vues et la heatmap exigent la permission analytics.view, et toute l'API passe par la session admin et une limitation de débit.

Les sous-requêtes du tableau de bord sont tolérantes aux pannes : une table absente renvoie zéro, jamais une exception qui casse la réponse.

  • Permission analytics.view exigée pour vues et heatmap
  • Débit limité et session admin sur toute l'API
  • Sous-requêtes tolérantes aux pannes, tables manquantes gérées
Pourquoi ça compte

L'IA agrège, vous décidez

Clustraly rassemble vos vues de pages, vos zones de chaleur et vos compteurs en réponses JSON nettes. À vous de lire le signal et d'orienter vos prochains contenus.

FAQ

Questions fréquentes

Quelles données expose l'API JSON admin analytics, heatmap & stats dashboard ?
Trois familles : les pages vues (aperçu, détail par jour et top 10), la heatmap de chaleur d'un article, et les compteurs agrégés du tableau de bord (articles, publiés, pages, médias, commentaires en attente, score SEO moyen, redirections, méta manquantes, analytics).
Sur quelle période puis-je consulter les pages vues ?
Vous passez un paramètre days, borné entre 1 et 90 jours. Toute valeur hors limites est ramenée dans cette plage, pour des requêtes toujours saines.
Que se passe-t-il si une table analytics ou heatmap manque ?
Le tableau de bord renvoie zéro pour le compteur concerné, et la heatmap transforme l'erreur SQL en JSON exploitable côté client au lieu d'une page d'erreur illisible.
Qui peut interroger ces endpoints ?
Les pages vues et la heatmap exigent la permission analytics.view ; les stats du tableau de bord s'appuient sur la session admin. Toute l'API est authentifiée et à débit limité, avec des réponses JSON aux codes HTTP adaptés.
Prêt à commencer ?

Vos données de contenu, prêtes à consommer en JSON

Branchez vos tableaux de bord sur l'API JSON admin analytics, heatmap & stats dashboard de Clustraly. Pages vues, zones de chaleur et compteurs arrivent en réponses propres, permissionnées et tolérantes aux pannes. L'IA agrège les chiffres, vous décidez de la suite.