تخطّ إلى المحتوى الرئيسي
SVDY Logo
دليل المطوّر
متاح الآن
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 دقائق.