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.
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 verstuurt deze voor je met autoSessionTracking: true en een ingestelde release, en de mobiele SDK's versturen ze vanzelf.
- Sessies worden 90 dagen bewaard.
- 409 als de gegevens van een ander platform komen dan dat van het project, bijvoorbeeld {"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"}. Events, sessies, logs, OTLP-traces en -metrics, bugmeldingen, replays en web vitals antwoorden allemaal zo. Geweigerde gegevens worden niet opgeslagen en tellen niet mee voor het quotum. De Blipit-SDK's loggen deze fout één keer en sturen de rest van de run niets meer. Los het op door een project voor dat platform aan te maken en de sleutel daarvan te gebruiken.
Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.