التعامل مع الويب هوك

تدفع خطافات الويب (webhooks) أحداث الحجوزات والفنيين إلى نقطة النهاية الخاصة بك في الوقت الفعلي — سجّل عنوان URL ومفتاح توقيع، وسيرسل CrispHive الأحداث فور وقوعها.

تسجيل نقطة نهاية

تسجّل عنوان HTTPS URL قابلًا للوصول علنًا مع مفتاح توقيع؛ ثم تدفع إجراءات النظام أحداث JSON إلى ذلك العنوان. يُعاد إرسال عمليات التسليم الفاشلة بتراجع أُسّي.

التحقق من التوقيعات

تتضمّن كل عملية تسليم ترويسة X-CrispHive-Signature. أعِد حساب HMAC-SHA256 للمتن الخام باستخدام مفتاح التوقيع الخاص بك وقارِن بوقت ثابت قبل الوثوق بالحمولة.

import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, signature, signingKey) {
  const expected = createHmac('sha256', signingKey)
    .update(rawBody)
    .digest('hex');
  return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}

كتالوج الأحداث