Envoi des enregistrements
Le SDK envoie les enregistrements à l’API publique (apiHost) par lots, sans bloquer la page.
- Un envoi toutes les 5 secondes, ou dès que les données en attente atteignent 500 Ko.
- Les envois sont compressés en gzip dans le navigateur (en clair si la compression échoue), sans requête préalable CORS.
- Quand l’onglet passe en arrière-plan ou se ferme, les données en attente partent aussitôt, en
keepalivepour survivre à la fermeture de la page (sauf au-delà de 60 Kio, la limite des navigateurs étant de 64 Kio).
Erreurs et renvois
Section intitulée « Erreurs et renvois »- Erreur réseau ou 5xx : renvoi avec un délai croissant (1 s, 2 s, 4 s… jusqu’à 30 s, avec une part aléatoire). Pendant l’attente, les envois suivants patientent. Après 10 renvois infructueux, les données en attente sont abandonnées.
- 429 (trop d’envois) : renvoi après le délai indiqué par l’en-tête
Retry-After. - Autres refus (400, 401, 413…) : jamais renvoyés.
Réponses qui arrêtent l’enregistrement
Section intitulée « Réponses qui arrêtent l’enregistrement »| Réponse | Cause | Effet |
|---|---|---|
403 origin_not_allowed |
L’origine de la page n’est pas dans les origines autorisées | La page cesse d’enregistrer, avec un avertissement dans la console, jusqu’à son rechargement. |
413 session_too_large |
La session dépasse 100 Mo enregistrés | La session n’est plus enregistrée, dans aucun onglet ni après un rechargement. La suivante l’est normalement. |
Limites de l’API
Section intitulée « Limites de l’API »- 5 Mo au plus par envoi, une fois décompressé.
- 120 envois par minute pour une session, 6 000 pour un projet ; au-delà, 429 et
Retry-After. - 100 Mo au plus pour une session.
Les enregistrements sont conservés 30 jours.