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).

js
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.

Bloccato? Scrivi a support@blipit.io. Le chiavi e il DSN esatto di ogni progetto sono sotto Chiavi API in app.blipit.io.