Clés API

Créez un bearer read-only pour lire les sites et agrégats de votre workspace depuis un outil externe.

Parcours reliant un snippet de site, un tableau de bord et un paiement. — Des tarifs qui suivent le niveau d’usage et les besoins du projet.

Créer et conserver la clé

Dans Paramètres, donnez un nom et choisissez un ou plusieurs scopes read-only : sites:read, analytics:read, revenue:read ou goals:read. Statrack affiche la valeur complète une seule fois. Elle est ensuite conservée uniquement sous forme d’empreinte : copiez-la dans votre gestionnaire de secrets. Une clé appartient à votre workspace, sans accès aux autres workspaces.

Lire une ressource

Envoyez la clé dans Authorization: Bearer. Les routes analytics, revenue et goals demandent website_id ; range_days accepte 7, 30 ou 90 et vaut 30 par défaut. Les réponses sont read-only et indiquent explicitement un agrégat empty quand aucune donnée n’est disponible.

example.ts

curl https://VOTRE_INSTANCE/api/v1/sites -H "Authorization: Bearer st_live_…"

curl https://VOTRE_INSTANCE/api/v1/analytics?website_id=ID -H "Authorization: Bearer st_live_…"

Révoquer et faire tourner

Une clé absente, invalide, expirée ou révoquée renvoie 401 et {"error":"unauthorized"}. Un scope manquant renvoie 403 ; un paramètre invalide renvoie 400. Révoquez une clé dans Paramètres dès qu’elle n’est plus nécessaire, puis créez une nouvelle clé pour la rotation. Statrack ne fournit pas de scope write.