API-referentie

Sessies

Endpoint POST /api/v1/sessions

Sessies bepalen adoptie en crash-free percentages op de pagina Releases. Stuur afzonderlijke sessies of geaggregeerde tellingen; een sessie heeft een release nodig.

1Request

Publieke sleutel in X-Blipit-Key of ?key= (voor sendBeacon). Eén sessieobject, {sessions: [...]} met maximaal 100, of {release, environment?, aggregates: [...]}. Een sessie: sid (8 tot 64 letters, cijfers, streepjes), release (verplicht), environment?, status (ok, errored, abnormal, crashed), errors? (een aantal boven 0 betekent errored), did? (gebruikers-id, alleen opgeslagen als hash-prefix), started? (ISO of epoch-seconden). Dezelfde sid opnieuw versturen behoudt de slechtste status.

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"}]}'

2Antwoorden

202 {accepted: n}. 400 als niets sid en release heeft, of meer dan 100 sessies. 401 onbekende sleutel.

Goed om te weten

  • 3.000 requests per minuut per sleutel.
  • De browser-SDK stuurt deze voor je met autoSessionTracking: true en een ingestelde release; session-items van Sentry SDK's worden ook gelezen.
  • Sessies worden 90 dagen bewaard.

Kom je er niet uit? Mail support@blipit.io. Sleutels en de exacte DSN van elk project staan onder API-sleutels in app.blipit.io.