Webhooks

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 في طابور لإعادة المحاولة لاحقًا.