API-referentie
Web vitals
Endpoint POST /api/v1/vitals
De browser-SDK stuurt deze beacon; het formaat is vast en klein, zodat het met sendBeacon als text/plain kan worden verstuurd zonder CORS-preflight.
1Request
Sleutel in ?key= of X-Blipit-Key, optionele instance. Body tot 4 KB, JSON als application/json of text/plain: path (1 tot 512 tekens, begint met /, geen ?, # of spaties), metrics {lcp, inp, cls, fcp, ttfb} (eindig, 0 tot 120 s; INP tot 60 s; CLS tot 100; elke deelverzameling), nav (het navigatietype; route voor een routewijziging in een single-page-app), connection en device (alleen bekende types).
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" })
);2Antwoorden
202 {ok: true}, of 202 {ok: true, skipped: 'bot'} voor bot-user-agents. 400 voor alles buiten de vorm. 401 of 403 bij sleutelproblemen.
Goed om te weten
- 1.200 requests per minuut per sleutel.
- Samples worden 30 dagen bewaard.
- Zet de query string niet in path; ingest weigert die.
- 409 als de gegevens van een ander platform komen dan dat van het project, bijvoorbeeld {"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"}. Events, sessies, logs, OTLP-traces en -metrics, bugmeldingen, replays en web vitals antwoorden allemaal zo. Geweigerde gegevens worden niet opgeslagen en tellen niet mee voor het quotum. De Blipit-SDK's loggen deze fout één keer en sturen de rest van de run niets meer. Los het op door een project voor dat platform aan te maken en de sleutel daarvan te gebruiken.
Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.