Référence API
Sessions
Endpoint POST /api/v1/sessions
Les sessions alimentent l'adoption et les taux sans crash sur la page Releases. Envoyez des sessions individuelles ou des comptes agrégés ; une session nécessite une release.
1Requête
Clé publique dans X-Blipit-Key ou ?key= (pour sendBeacon). Un objet session, {sessions: [...]} avec au plus 100, ou {release, environment?, aggregates: [...]}. Une session : sid (8 à 64 lettres, chiffres, tirets), release (requis), environment?, status (ok, errored, abnormal, crashed), errors? (un compte supérieur à 0 signifie errored), did? (id utilisateur, stocké uniquement comme préfixe de hachage), started? (ISO ou secondes epoch). Renvoyer le même sid conserve le pire statut.
curl "https://in.blipit.io/api/v1/sessions" \
-H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
-d '{"sessions":[{"sid":"c1f2a9d4e7b8","did":"user-42","status":"crashed","release":"shop@1.4.2","environment":"production"}]}'2Réponses
202 {accepted: n}. 400 quand rien n'a de sid et de release, ou plus de 100 sessions. 401 clé inconnue.
Bon à savoir
- 3 000 requêtes par minute et par clé.
- Le SDK navigateur les envoie pour vous avec autoSessionTracking: true et une release définie, et les SDK mobiles les envoient d'eux-mêmes.
- Les sessions sont conservées 90 jours.
- 409 quand les données viennent d'une autre plateforme que celle du projet, par exemple {"error": "This project is for iOS. Create a separate Android project in Blipit and use its key.", "reason": "platform_mismatch", "project_platform": "ios", "sent_platform": "android"}. Les événements, sessions, logs, traces et métriques OTLP, rapports de bug, replays et web vitals répondent tous ainsi. Les données refusées ne sont pas enregistrées et ne comptent pas dans le quota. Les SDK Blipit écrivent cette erreur une fois dans les logs et n'envoient plus rien pendant le reste de l'exécution. Pour corriger, créez un projet pour cette plateforme et utilisez sa clé.
Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.