Riferimento API
Web vitals
Endpoint POST /api/v1/vitals
L'SDK per browser invia questo beacon; il formato è fisso e piccolo così può partire con sendBeacon come text/plain senza preflight CORS.
1Richiesta
Chiave in ?key= o X-Blipit-Key, istanza facoltativa. Corpo fino a 4 KB, JSON come application/json o text/plain: path (da 1 a 512 caratteri, inizia con /, senza ?, # o spazi), metrics {lcp, inp, cls, fcp, ttfb} (finiti, da 0 a 120 s; INP fino a 60 s; CLS fino a 100; qualsiasi sottoinsieme), nav (il tipo di navigazione; route per un cambio di route di una single-page app), connection e device (solo tipi noti).
navigator.sendBeacon(
"https://in.blipit.io/api/v1/vitals?key=<public key>",
JSON.stringify({ path: "/checkout", metrics: { lcp: 1840, cls: 0.03, ttfb: 320 }, nav: "navigate", device: "mobile", connection: "4g" })
);2Risposte
202 {ok: true}, oppure 202 {ok: true, skipped: 'bot'} per user agent di bot. 400 per qualsiasi cosa fuori dalla forma. 401 o 403 per problemi di chiave.
Buono a sapersi
- 1.200 richieste al minuto per chiave.
- I campioni sono conservati 30 giorni.
- Non mettere la query string in path; l'ingest la rifiuta.
- 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.