التكاملات
Webhooks
التثبيت an https endpoint you control
ترسل قناة webhook جسم JSON إلى عنوانك لكل تنبيه وتوقّعه بسر تنسخه مرة واحدة. تحقق من التوقيع قبل أن تثق بالجسم.
الصقها في Claude Code أو Cursor أو أي مساعد برمجة بالذكاء الاصطناعي. تحتوي على الخطوات والشيفرة. في app.blipit.io ضمن مفاتيح API تجد التعليمات نفسها مع مفتاحك مكتوباً فيها.
1أضف القناة
التكاملات، Webhook: أدخل عنوان https، واختر نطاق المشاريع وأي التنبيهات. يُعرض سر التوقيع (whsec_...) مرة واحدة: «انسخ سر التوقيع الآن. لن يُعرض مرة أخرى.»
2التحقق من التوقيع
الترويسة x-blipit-signature هي HMAC-SHA256 بصيغة hex لجسم الطلب الخام باستخدام سرك. قارن بزمن ثابت.
import { createHmac, timingSafeEqual } from "node:crypto";
export function verify(rawBody, header, secret) {
const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}3قراءة الجسم
تبدو تنبيهات المشكلات هكذا. type هو new_issue أو regression أو security أو test؛ ويوجد security فقط للتنبيهات الأمنية.
{
"type": "new_issue",
"project": { "id": 12, "name": "shop" },
"issue": { "id": 981, "title": "TypeError: cart is undefined", "url": "https://app.blipit.io/issues/981", "level": "error", "event_count": 1 },
"event": { "release": "2026.09.28", "environment": "production", "platform": "javascript" },
"sent_at": "2026-09-28T09:15:00.000Z"
}من المفيد معرفته
- تُرسل تغييرات أدوات المراقبة بالطريقة نفسها مع type بقيمة monitor.down أو monitor.up، والإشعارات monitor.slow وmonitor.fast وmonitor.expiring.
- تُقبل عناوين https على العناوين العامة فقط؛ ولا تُتبع عمليات إعادة التوجيه. استخدم زر الاختبار بعد الحفظ لرؤية تسليم بقيمة type: test.
- أجب بـ 2xx بسرعة. يظهر التسليم الفاشل كخطأ على القناة؛ ولا يضعه Blipit في طابور لإعادة المحاولة لاحقًا.
- تُرسَل بلاغات الأخطاء الجديدة بالنوع bug_report.new مع project وقائمة reports: id وurl وkind وtitle وpage_url وreporter وscreenshots وrecordings وstill_uploading. وتصل عدة بلاغات معًا في جسم واحد.
هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.