اعرف فور حدوث الأمر
تستقبل الواجهة الخلفية POST خلال ثوانٍ من تسجيل الموظف للحضور أو اعتماد إجازة — بلا polling ولا مهام مجدولة. تسليمات موقّعة، إعادة محاولات تلقائية، وقائمة Dead-Letter إن تعطّل نقطة الوصول لديك.
ما يمكنك فعله
نتائج فورية من اليوم الأول. لا حاجة لمهندس — يستطيع مسؤول الشركات الصغيرة والمتوسطة إعدادها.
في الزمن الحقيقي بلا استطلاع متكرر
تسجيل الحضور، اعتماد الإجازات، تغييرات حالة العمليات — تصل إلى نقطة النهاية لديك على شكل POST خلال ثوانٍ. لا حاجة لاستعلام الـ API كل 5 دقائق (أرخص وأسرع).
تسليم محصّن ضد التلاعب
يحوي كل طلب رأس X-SVDY-Signature: sha256=… يُحسب على جسم JSON باستخدام السر الخاص بك. تحقّق من التوقيع داخل نقطة النهاية لرفض أي طلبات مزوّرة فورًا.
إعادة محاولة + قائمة الرسائل الميتة
أي استجابة خارج النطاق 2xx تُعاد المحاولة بعد دقيقة، 5 دقائق، 30 دقيقة، ساعتين، ثم 12 ساعة. بعد 5 محاولات فاشلة ينتقل التسليم إلى قائمة dead-letter ويمكن مراجعته في /system/integrations/webhooks. لن تفقد الأحداث حين يتعطّل طرفك مؤقّتًا.
إعداد في 4 خطوات
الوقت المتوقّع: أقل من 5 دقائق لمسؤول لديه بيانات الاعتماد جاهزة.
أنشئ webhook من لوحة إدارة المؤسسة
التكاملات ← Webhooks ← إضافة Webhook. أدخل رابط نقطة النهاية واختر الأحداث التي تهمّك. تعرض SVDY سرّ التوقيع مرة واحدة فقط — احفظه على الفور.
ابنِ المستقبِل
تستقبل نقطة النهاية لديك POST application/json. تحقّق من توقيع HMAC قبل المعالجة. أرجع 200 خلال 10 ثوانٍ (وإلا تعتبر SVDY العملية فاشلة وتعيد المحاولة).
# Python receiver — Flask sketch
import hmac, hashlib, json
from flask import request, abort
SVDY_SECRET = b"<paste-from-svdy-admin>"
@app.post("/webhooks/svdy")
def receive():
sig = request.headers.get("X-SVDY-Signature", "")
expected = "sha256=" + hmac.new(
SVDY_SECRET, request.data, hashlib.sha256
).hexdigest()
if not hmac.compare_digest(sig, expected):
abort(401)
event = json.loads(request.data)
# ... handle event["type"], event["data"]
return "", 200اختبر بزر "Send test event"
من داخل لوحة تفاصيل الـ webhook — يُطلق حدثًا اصطناعيًا نحو نقطة النهاية. تظهر الاستجابة وكود الحالة فورًا في سجل التسليم.
أعِد إرسال التسليمات الفاشلة
كل عملية تسليم تظهر في لوحة النشاط بحالتها (تم التسليم / إعادة المحاولة / dead). بعد إصلاح نقطة النهاية، اضغط "Replay" على أي تسليم في dead-letter لإطلاقه من جديد.
هل أنت مستعد للربط؟
افتح لوحة إدارة مؤسستك → عمليات الدمج واربط هذا التكامل في أقل من 5 دقائق.
