تخطّ إلى المحتوى الرئيسي
دليل المطوّر
متاح الآن
Professional الباقة

اعرف فور حدوث الأمر

تستقبل الواجهة الخلفية POST خلال ثوانٍ من تسجيل الموظف للحضور أو اعتماد إجازة — بلا polling ولا مهام مجدولة. تسليمات موقّعة، وإعادة محاولات تلقائية، وقائمة انتظار للتسليمات الفاشلة (قائمة Dead-Letter) إن تعطّلت نقطة الوصول لديك.

ما يمكنك فعله

نتائج فورية من اليوم الأول. لا حاجة لمهندس — يستطيع مسؤول الشركات الصغيرة والمتوسطة إعدادها.

في الزمن الحقيقي بلا استطلاع متكرر

تسجيل الحضور، اعتماد الإجازات، تغييرات حالة العمليات — تصل إلى نقطة النهاية لديك على شكل POST خلال ثوانٍ. لا حاجة لاستعلام الـ API كل 5 دقائق (أرخص وأسرع).

تسليم محصّن ضد التلاعب

يحوي كل طلب رأس X-SVDY-Signature: sha256=… يُحسب على جسم JSON باستخدام السر الخاص بك. تحقّق من التوقيع داخل نقطة النهاية لرفض أي طلبات مزوّرة فورًا.

إعادة المحاولة وقائمة التسليمات الفاشلة

أي استجابة خارج النطاق 2xx تُعاد المحاولة بعد دقيقة، 5 دقائق، 30 دقيقة، ساعتين، ثم 12 ساعة. بعد 5 محاولات فاشلة ينتقل التسليم إلى قائمة التسليمات الفاشلة (قائمة dead-letter) ويمكن مراجعته في /system/integrations/webhooks. لن تفقد الأحداث حين يتعطّل طرفك مؤقّتًا.

إعداد في 4 خطوات

الوقت المتوقّع: أقل من 5 دقائق لمسؤول لديه بيانات الاعتماد جاهزة.

1

أنشئ webhook من لوحة إدارة المؤسسة

التكاملات ← Webhooks ← إضافة Webhook. أدخل رابط نقطة النهاية واختر الأحداث التي تهمّك. تعرض SVDY سرّ التوقيع مرة واحدة فقط — احفظه على الفور.

2

ابنِ المستقبِل

تستقبل نقطة النهاية لديك 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
3

اختبر بزر "Send test event"

من داخل لوحة تفاصيل الـ webhook — يُطلق حدثًا اصطناعيًا نحو نقطة النهاية. تظهر الاستجابة وكود الحالة فورًا في سجل التسليم.

4

أعِد إرسال التسليمات الفاشلة

كل عملية تسليم تظهر في لوحة النشاط بحالتها (تم التسليم / إعادة المحاولة / dead). بعد إصلاح نقطة النهاية، اضغط "Replay" على أي تسليم في dead-letter لإطلاقه من جديد.


هل أنت مستعد للربط؟

افتح لوحة إدارة مؤسستك → عمليات الدمج واربط هذا التكامل في أقل من 5 دقائق.