API referansı
Web vitals
Endpoint POST /api/v1/vitals
Tarayıcı SDK'sı bu beacon'ı gönderir; format sabit ve küçüktür, böylece CORS preflight olmadan sendBeacon ile text/plain olarak gönderilebilir.
1İstek
Anahtar ?key= ya da X-Blipit-Key içinde, isteğe bağlı örnek. Gövde en fazla 4 KB, application/json ya da text/plain olarak JSON: path (1 ile 512 karakter, / ile başlar, ?, # ya da boşluk içermez), metrics {lcp, inp, cls, fcp, ttfb} (sonlu, 0 ile 120 s; INP en fazla 60 s; CLS en fazla 100; herhangi bir alt küme), nav (navigasyon türü; tek sayfalı uygulama route değişikliği için route), connection ve device (yalnızca bilinen türler).
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" })
);2Yanıtlar
202 {ok: true} ya da bot user agent'ları için 202 {ok: true, skipped: 'bot'}. 400 biçimin dışındaki her şey için. 401 ya da 403 anahtar sorunları için.
Bilmekte fayda var
- Anahtar başına dakikada 1.200 istek.
- Örnekler 30 gün saklanır.
- path içine sorgu dizesi koymayın; ingest reddeder.
- Veriler projenin platformundan farklı bir platformdan geldiğinde 409 döner, örneğin {"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"}. Olaylar, oturumlar, loglar, OTLP iz ve metrikleri, hata raporları, replay'ler ve web vitals aynı şekilde yanıt verir. Reddedilen veriler saklanmaz ve kotaya sayılmaz. Blipit SDK'ları bu hatayı bir kez loglar ve çalışmanın geri kalanında göndermeyi durdurur. Çözmek için o platform için bir proje oluşturun ve onun anahtarını kullanın.
Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve proje id'si app.blipit.io içindeki API anahtarları altındadır.