Web vitals

Endpoint POST /api/v1/vitals

El SDK de navegador envía este beacon; el formato es fijo y pequeño para que pueda salir con sendBeacon como text/plain sin preflight de CORS.

1Petición

Clave en ?key= o X-Blipit-Key, instancia opcional. Cuerpo de hasta 4 KB, JSON como application/json o text/plain: path (de 1 a 512 caracteres, empieza por /, sin ?, # ni espacios), metrics {lcp, inp, cls, fcp, ttfb} (finitos, de 0 a 120 s; INP hasta 60 s; CLS hasta 100; cualquier subconjunto), nav (el tipo de navegación; route para un cambio de ruta de single-page app), connection y device (solo tipos conocidos).

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" })
);

2Respuestas

202 {ok: true}, o 202 {ok: true, skipped: 'bot'} para user agents de bots. 400 para cualquier cosa fuera de la forma. 401 o 403 por problemas de clave.

Conviene saber

  • 1.200 peticiones por minuto y clave.
  • Las muestras se conservan 30 días.
  • No pongas la query string en path; la ingesta la rechaza.

¿Atascado? Escribe a support@blipit.io. Las claves y el DSN exacto de cada proyecto están en Claves API en app.blipit.io.