Authentification
L’API REST de Statnive utilise l’authentification WordPress REST standard. Vous pouvez vous authentifier avec des mots de passe d’application, l’authentification par Cookie (pour les utilisateurs connectés), ou tout Plugin d’authentification compatible avec l’API REST WordPress. Tous les endpoints requièrent la capacité manage_options par défaut.
URL de base
Tous les endpoints sont enregistrés sous le namespace statnive/v1 :
https://yoursite.com/wp-json/statnive/v1/
Endpoints disponibles
GET /stats/summary
Retourne un résumé des indicateurs clés pour une plage de dates donnée.
Paramètres :
from(string, obligatoire) — Date de début au formatYYYY-MM-DD.to(string, obligatoire) — Date de fin au formatYYYY-MM-DD.
Réponse :
{
"visitors": 1234,
"pageviews": 3456,
"sources": { "organic_search": 520, "social": 310, "direct": 280 },
"top_pages": [{ "path": "/", "views": 890 }]
}
GET /stats/sources
Retourne la répartition des sources de trafic par canal.
GET /stats/pages
Retourne les analyses au niveau des pages, triées par nombre de pages vues.
GET /stats/realtime
Retourne le nombre actuel de visiteurs actifs et le flux récent des pages vues.
Limitation du débit
Les requêtes API sont limitées à 60 requêtes par minute par utilisateur authentifié. Cette limite est appliquée au niveau de l’application et renvoie une réponse 429 Too Many Requests lorsqu’elle est dépassée.