مرجع API
مؤشرات الويب الحيوية
نقطة النهاية POST /api/v1/vitals
يرسل SDK المتصفح هذا الإشارة؛ الصيغة ثابتة وصغيرة لتُرسل عبر sendBeacon كـ text/plain بدون فحص CORS مسبق.
1الطلب
المفتاح في ?key= أو X-Blipit-Key، والنسخة اختيارية. الجسم حتى 4 كيلوبايت، JSON كـ application/json أو text/plain: path (من 1 إلى 512 حرفًا، يبدأ بـ /، بدون ? أو # أو مسافات)، وmetrics {lcp, inp, cls, fcp, ttfb} (محدودة، من 0 إلى 120 ث؛ INP حتى 60 ث؛ CLS حتى 100؛ أي مجموعة فرعية)، وnav (نوع التنقل؛ route لتغيير مسار في تطبيق صفحة واحدة)، وconnection وdevice (الأنواع المعروفة فقط).
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" })
);2الاستجابات
202 {ok: true}، أو 202 {ok: true, skipped: 'bot'} لوكلاء مستخدم الروبوتات. 400 لأي شيء خارج الشكل. 401 أو 403 لمشكلات المفتاح.
من المفيد معرفته
- 1,200 طلب في الدقيقة لكل مفتاح.
- يُحتفظ بالعينات لمدة 30 يومًا.
- لا تضع سلسلة الاستعلام في path؛ يرفضها الاستقبال.
هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح وDSN الدقيق لكل مشروع موجودة تحت مفاتيح API في app.blipit.io.

