Riferimento API
Sessioni
Endpoint POST /api/v1/sessions
Le sessioni alimentano adozione e tassi crash-free nella pagina Release. Invia sessioni singole o conteggi aggregati; una sessione richiede una release.
1Richiesta
Chiave pubblica in X-Blipit-Key o ?key= (per sendBeacon). Un oggetto sessione, {sessions: [...]} con al massimo 100, oppure {release, environment?, aggregates: [...]}. Una sessione: sid (da 8 a 64 lettere, cifre, trattini), release (obbligatoria), environment?, status (ok, errored, abnormal, crashed), errors? (un conteggio sopra 0 significa errored), did? (id utente, salvato solo come prefisso di hash), started? (ISO o secondi epoch). Inviare di nuovo lo stesso sid mantiene lo stato peggiore.
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"}]}'2Risposte
202 {accepted: n}. 400 quando nulla ha sid e release, o più di 100 sessioni. 401 chiave sconosciuta.
Buono a sapersi
- 3.000 richieste al minuto per chiave.
- L'SDK per browser le invia per te con autoSessionTracking: true e una release impostata, e gli SDK mobile le inviano da soli.
- Le sessioni sono conservate 90 giorni.
- 409 quando i dati arrivano da una piattaforma diversa da quella del progetto, per esempio {"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"}. Eventi, sessioni, log, trace e metriche OTLP, segnalazioni di bug, replay e web vitals rispondono tutti così. I dati rifiutati non vengono salvati e non contano nella quota. Gli SDK di Blipit registrano questo errore una volta e smettono di inviare per il resto dell'esecuzione. Per risolvere, crea un progetto per quella piattaforma e usa la sua chiave.
Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.