X-API-Key) et la lecture dashboard (JWT).
Base URL
Le SDK ajoute automatiquement le chemin/v1/events à l’endpoint que vous
configurez.
Principes
Batch
Les événements sont envoyés groupés dans une envelope
{ "events": [ ... ] }.Idempotent
Déduplication par
eventId (UUID) : un batch rejoué ne crée pas de doublon.Authentifié
En-tête
X-API-Key sur chaque requête d’ingestion.Enrichi côté serveur
L’API ajoute
properties.server (IP, hash, géo, ingestedAt).Pages
Authentification
En-tête
X-API-Key, rotation et bonnes pratiques.Ingérer des événements
POST /v1/events : requête, réponse et gestion des erreurs.Schéma d'événement
Le type
Event et l’envelope batch en détail.Au-delà de l’ingestion, l’API expose des endpoints de lecture pour le dashboard
(KPIs, funnels, rétention, acquisition, goals, insights). Ils sont protégés par
JWT et documentés séparément côté produit.