Referencia de la API
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).
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.