الجلسات

نقطة النهاية POST /api/v1/sessions

تحرّك الجلسات التبنّي ومعدلات الخلو من الأعطال في صفحة الإصدارات. أرسل جلسات فردية أو أعدادًا مجمّعة؛ تحتاج الجلسة إلى release.

1الطلب

المفتاح العام في X-Blipit-Key أو ?key= (لـ sendBeacon). كائن جلسة واحد، أو {sessions: [...]} بحد أقصى 100، أو {release, environment?, aggregates: [...]}. الجلسة: sid (من 8 إلى 64 حرفًا ورقمًا وشرطة)، وrelease (مطلوب)، وenvironment?، وstatus ‏(ok أو errored أو abnormal أو crashed)، وerrors? (عدد أكبر من 0 يعني errored)، وdid? (معرّف المستخدم، يُخزّن فقط كبادئة تجزئة)، وstarted? ‏(ISO أو ثوانٍ epoch). إرسال sid نفسه مرة أخرى يحتفظ بأسوأ حالة.

sh
curl "https://in.blipit.io/api/v1/sessions" \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
  -d '{"sessions":[{"sid":"c1f2a9d4e7b8","did":"user-42","status":"crashed","release":"shop@1.4.2","environment":"production"}]}'

2الاستجابات

202 {accepted: n}. 400 عندما لا يحمل أي عنصر sid وrelease، أو أكثر من 100 جلسة. 401 مفتاح مجهول.

من المفيد معرفته

  • 3,000 طلب في الدقيقة لكل مفتاح.
  • ترسل حزمة المتصفح هذه نيابة عنك مع autoSessionTracking: true وإصدار محدد، وترسلها حزم الجوال تلقائيًا.
  • يُحتفظ بالجلسات لمدة 90 يومًا.
  • 409 عندما تأتي البيانات من منصة غير منصة المشروع، مثلًا {"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"}. تجيب الأحداث والجلسات والسجلات وتتبعات ومقاييس OTLP وتقارير الأخطاء وتسجيلات الجلسات وweb vitals كلها بهذه الطريقة. البيانات المرفوضة لا تُحفظ ولا تُحسب من الحصة. تسجّل حزم Blipit SDK هذا الخطأ مرة واحدة وتتوقف عن الإرسال لبقية التشغيل. للإصلاح، أنشئ مشروعًا لتلك المنصة واستخدم مفتاحه.

هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.