L’unique endpoint d’écriture du SDK. Il reçoit un batch d’événements et renvoie les identifiants acceptés.

Requête

En-têtes

string
requis
Clé projet. Voir Authentification.
string
requis
Toujours application/json.

Corps

Event[]
requis
Tableau d’événements. Voir Schéma d’événement.

Exemple cURL

Réponse

number
Nombre d’événements acceptés dans ce batch.
string[]
Liste des eventId acceptés. Le SDK purge de sa file uniquement ces IDs.

Idempotence

Chaque eventId est unique côté client et immuable au retry. Côté ingestion, la déduplication (ON CONFLICT DO NOTHING) garantit qu’un batch rejoué après un échec réseau ne crée aucun doublon. Voir Offline-first.

Erreurs

La file locale n’est jamais purgée avant confirmation. Seuls les eventIds renvoyés dans la réponse sont retirés.