مرجع API
الأحداث
نقطة النهاية POST /api/v1/events
تأخذ نقطة نهاية الأحداث حدث JSON واحدًا بمخطط Blipit v1 وتضعه في الطابور. وهي ما تستدعيه كل حزم Blipit SDK ووحدة Odoo.
1الطلب
المفتاح في X-Blipit-Key (عام أو سري) أو ?key=. يرسل Odoo أيضًا X-Blipit-Instance. الجسم حتى 256 كيلوبايت، متداخل حتى 32 مستوى كحد أقصى. المطلوب: event_id (32 hex بأحرف صغيرة)، وtimestamp (ISO 8601)، وplatform، وsdk {name, version}، ورسالة أو استثناء. الاختياري: level وrelease وenvironment وuser {id, email, username} وtags وbreadcrumbs وrequest {method, url, headers} وcontexts وfingerprint (مصفوفة سلاسل نصية تحل محل التجميع المحسوب) وsecurity (المفتاح السري فقط).
curl https://in.blipit.io/api/v1/events \
-H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
-d '{
"event_id": "0123456789abcdef0123456789abcdef",
"timestamp": "2026-09-28T09:15:00Z",
"platform": "python",
"level": "error",
"release": "shop@1.4.2",
"environment": "production",
"exception": {
"type": "KeyError",
"value": "customer_id",
"stacktrace": { "frames": [{ "filename": "shop/cart.py", "function": "checkout", "lineno": 42, "in_app": true }] }
},
"tags": { "company_id": "1" },
"sdk": { "name": "my-sdk", "version": "1.0.0" }
}'2الاستجابات
202 {id} مقبول. 202 {accepted: false, sampled: true, plan} فوق الحد الشهري ومستبعد بالعينة: حُسب الحدث ولم يُخزّن. 202 {accepted: false, dropped: true, plan} بعد سقف التجاوز (الحد في الخطة المجانية، وضعف الحد في الخطط المدفوعة): لا يُحتفظ بشيء حتى الشهر التالي. 400 خطأ مخطط مع التفاصيل، أو تداخل عميق جدًا. 401 مفتاح مجهول. 403 مفتاح مرتبط بنسخة أخرى، أو حدث أمني بمفتاح عام (security_needs_secret_key)، أو مراقبة أمان غير مشمولة في الخطة. 429 تجاوز حد المعدل.
من المفيد معرفته
- 300 طلب في الدقيقة لكل مفتاح، مشتركة مع النطاقات والسجلات.
- إرسال event_id نفسه مرتين يخزّنه مرة واحدة.
- لا يستطيع المفتاح العام ضبط tags.db؛ يُسقط كي لا يُسمَّم أساس اكتشاف نسخ Odoo.
- 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.