API-Referenz

Sessions

Endpoint POST /api/v1/sessions

Sessions treiben Adoption und Crash-free-Raten auf der Releases-Seite an. Senden Sie einzelne Sessions oder aggregierte Zahlen; eine Session braucht ein Release.

1Request

Öffentlicher Schlüssel in X-Blipit-Key oder ?key= (für sendBeacon). Ein Session-Objekt, {sessions: [...]} mit höchstens 100, oder {release, environment?, aggregates: [...]}. Eine Session: sid (8 bis 64 Buchstaben, Ziffern, Bindestriche), release (erforderlich), environment?, status (ok, errored, abnormal, crashed), errors? (eine Anzahl über 0 bedeutet errored), did? (Nutzer-ID, nur als Hash-Präfix gespeichert), started? (ISO oder Epoch-Sekunden). Dieselbe sid erneut zu senden behält den schlechtesten 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"}]}'

2Antworten

202 {accepted: n}. 400, wenn nichts sid und release hat oder mehr als 100 Sessions. 401 unbekannter Schlüssel.

Gut zu wissen

  • 3.000 Requests pro Minute und Schlüssel.
  • Das Browser-SDK sendet diese für Sie mit autoSessionTracking: true und gesetztem Release; Session-Items von Sentry-SDKs werden ebenfalls gelesen.
  • Sessions werden 90 Tage aufbewahrt.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und den genauen DSN jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.