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.

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

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.