API HTTP de lecture

Takt expose une API HTTP de lecture pour interroger les statistiques d’un site depuis un programme ou un agent. Elle réutilise les endpoints /api/v1/sites/{domain}/stats/* et s’authentifie par clé d’API (pas de cookie de session).

Authentification

Crée une clé d’API avec la permission stats:read depuis les paramètres de ton org, puis transmets-la en en-tête Authorization :

curl -H "Authorization: Bearer takt_sk_xxx" \
  "https://app.taktlytics.com/api/v1/sites/exemple.com/stats/summary?from=2026-03-01T00:00:00Z&to=2026-03-08T00:00:00Z"

Une clé est liée à un seul site. Une clé invalide renvoie 401 ; une clé sans la bonne permission ou visant un autre domaine renvoie 404 (anti-énumération).

Endpoints

La plupart des routes de lecture sont sous /api/v1/sites/{domain}/stats/ : summary, timeseries, breakdown, realtime, goals, funnels, properties, revenue. L’export CSV/JSON utilise un chemin distinct, /api/v1/orgs/{org}/sites/{domain}/stats/export, avec la même authentification par clé. Le contrat détaillé (paramètres, schémas de réponse) est décrit dans la spécification OpenAPI (api/openapi.yaml).

Quotas & facturation

L’accès à l’API de lecture relève de l’add-on API/IA de ton offre, mesuré en nombre de requêtes par mois. Chaque requête de lecture réussie compte pour 1 unité. Les refus (clé invalide, quota dépassé, mauvais domaine) ne sont pas comptés.