Riferimento API
Replay
Endpoint POST /api/v1/replays/:replayId/segments/:n and /meta
L'SDK per browser usa questi due endpoint; li chiameresti solo da un registratore personalizzato. Un replay è composto da fino a 500 segmenti di eventi rrweb.
1Segmenti
POST /api/v1/replays/<replayId>/segments/<n>: replayId è di 32 caratteri esadecimali, n va da 0 a 499. Chiave (pubblica o segreta) in X-Blipit-Key o ?key=, istanza facoltativa. Il corpo è un array JSON di eventi rrweb, grezzo o gzip (Content-Encoding: gzip), fino a 2 MB, decompresso al massimo 32 MB. Il primo segmento consuma un replay dalla quota mensile.
2Metadati
POST /api/v1/replays/<replayId>/meta con un corpo JSON fino a 16 KB: url, duration (ms), error_ids (id degli eventi), browser, os. Il replay deve già esistere in questo progetto.
3Risposte
202 {accepted: true, duplicate?} salvato. 202 {accepted: false, reason: 'replay_quota'} il workspace ha esaurito i replay del mese; smetti di registrare. 202 {accepted: false, reason: 'replay_full'} il replay ha raggiunto 500 segmenti o 20 MB. 400 id, numero di segmento o corpo non validi. 409 l'id del replay appartiene a un altro progetto. 404 meta per un replay sconosciuto.
Buono a sapersi
- 1.200 richieste al minuto per chiave.
- Le richieste da bot noti ricevono 202 e vengono scartate.
- I segmenti sono salvati come inviati e restituiti al player 20 alla volta.
- 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.