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.
  • 409 cuando los datos vienen de una plataforma distinta a la del proyecto, por ejemplo {"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"}. Eventos, sesiones, logs, trazas y métricas OTLP, informes de errores, replays y web vitals responden igual. Los datos rechazados no se guardan ni cuentan para la cuota. Los SDK de Blipit registran este error una vez y dejan de enviar durante el resto de la ejecución. Para solucionarlo, crea un proyecto para esa plataforma y usa su clave.

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