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.
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, und die mobilen SDKs senden sie von selbst.
- Sessions werden 90 Tage aufbewahrt.
- 409, wenn die Daten von einer anderen Plattform kommen als der des Projekts, zum Beispiel {"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, Sessions, Logs, OTLP-Traces und -Metriken, Fehlerberichte, Replays und Web Vitals antworten alle so. Abgelehnte Daten werden nicht gespeichert und nicht auf das Kontingent angerechnet. Die Blipit-SDKs schreiben diesen Fehler einmal ins Log und senden für den Rest der Laufzeit nichts mehr. Zur Behebung ein Projekt für diese Plattform anlegen und dessen Schlüssel verwenden.
Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und die Projekt-ID jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.