الأحداث

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} فوق الحد الشهري: حُسب الحدث ولم يُخزّن. 400 خطأ مخطط مع التفاصيل، أو تداخل عميق جدًا. 401 مفتاح مجهول. 403 مفتاح مرتبط بنسخة أخرى، أو حدث أمني بمفتاح عام (security_needs_secret_key)، أو مراقبة أمان غير مشمولة في الخطة. 429 تجاوز حد المعدل.

3حزم Sentry SDK

POST /api/<project id>/envelope/ والأقدم /api/<project id>/store/، المفتاح في X-Sentry-Auth أو ?sentry_key=، الجسم بـ gzip أو deflate أو brotli حتى 1 ميغابايت (4 ميغابايت بعد فك الضغط). يجب أن ينتمي المفتاح إلى المشروع في عنوان URL. حتى 10 عناصر حدث لكل مغلف؛ تصبح عناصر transaction وspan نطاقات؛ وتغذي عناصر session وsessions وuser_report وfeedback صحة الإصدارات والملاحظات؛ وتُسقط إعادات التشغيل والملفات التعريفية.

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

• 300 طلب في الدقيقة لكل مفتاح، مشتركة مع النطاقات والسجلات.
• إرسال event_id نفسه مرتين يخزّنه مرة واحدة.
• لا يستطيع المفتاح العام ضبط tags.db؛ يُسقط كي لا يُسمَّم أساس اكتشاف نسخ Odoo.