Base URL
Authentification
L’API accepte deux formes d’authentification :Bearer JWT (session utilisateur)
Utilisé par le dashboard React. Vous récupérez le token viasupabase.auth.getSession() côté client et l’envoyez en header :
API Key (programmatique)
Pour les intégrations serveur à serveur, générez une API key dans Paramètres → API & Webhooks. Envoyez-la en header :Rate limiting
Toutes les routes sont rate-limitées. Limites par défaut :| Type de route | Limite | Fenêtre |
|---|---|---|
| Auth (signup, login) | 5 req | 60 s / IP |
| LLM (chat, copilot) | 20-30 req | 60 s / user |
| Lectures (usage, metrics) | 60 req | 60 s / user |
| Webhooks entrants | Signature check uniquement | — |
429 Too Many Requests avec header Retry-After: <seconds>.
Format des réponses
Toutes les réponses sont JSON avec UTF-8 :Succès
Erreur
request_id est un Sentry event ID que vous pouvez partager au support Actero pour tracer le problème.
Idempotence sur les webhooks
Les webhooks entrants (Stripe, Shopify, Gorgias, etc.) sont dédupliqués par(provider, event_id) pendant 30 jours. Si votre upstream réessaie un même event, Actero retourne 200 sans ré-exécuter le handler.
Versioning
L’API n’est pas encore versionnée publiquement. Changements breaking annoncés 30 jours à l’avance par email + banner dans le dashboard.Ressources
Authentication
Détails des deux schémas d’auth
Webhooks sortants
S’abonner aux événements Actero
Rate limits
Comportement et retry strategy
Export GDPR
Récupérer toutes vos données