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.

sh
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 ; les éléments session des SDK Sentry sont lus aussi.
  • Les sessions sont conservées 90 jours.

Bloqué ? Écrivez à support@blipit.io. Les clés et le DSN exact de chaque projet sont sous Clés API dans app.blipit.io.