إرسال الأحداث إلى نظامك الخاص باستخدام webhooks

يسمح الويب لـ IDup بالاتصال بعنوان الويب الخاص بك في اللحظة التي يحدث فيها شيء ما، على سبيل المثال عند دفع فاتورة. يتم توقيع كل تسليم وتكراره إذا لم يرد نظامك.

إضافة نقطة نهاية

1. افتح الويب هوك علامة التبويب واضغط إضافة نقطة نهاية.
2. أدخل الاسم و URL. يجب أن يكون قابلاً للوصول علنًا. يتم رفض العناوين داخل شبكة خاصة لأسباب أمنية.
3. ضع علامة على الأحداث ما تريد.
4. اختياري: اختر مفتاح API. يستقبل نقطة النهاية بعد ذلك فقط الأحداث التي يمكن لهذا المفتاح قراءتها.
5. اضغط حفظ. يعرض IDup سر توقيعك مرة واحدة. احفظه بأمان.

الأحداث

• تم إنشاء الفاتورة, تم دفع الفاتورة, تم استلام الدفع
• عميل جديد, جهة اتصال جديدة, عميل محتمل جديد, تذكرة جديدة
• تم قبول العرض — عرض سعر قبله العميل

كل تسليم يحمل ثلاثة رؤوس: اسم الحدث، رقم التسليم والتوقيع. المحاولة الجديدة تحتفظ بنفس رقم التسليم، لذا يمكن لنظامك التعرف على التكرارات.

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

يجب أن يقوم نظامك بحساب HMAC-SHA256 على الوقت والجسم الخام باستخدام سرك، ومقارنته بالتوقيع، ورفض الوقت الأقدم من 5 دقائق. اضغط التحقق من التوقيع والأمثلة للكود الجاهز.

اختبار، إيقاف مؤقت وتجديد

• إرسال اختبار يرسل حدث اختبار ويظهر رمز HTTP والوقت المستغرق.
• إيقاف مؤقت يوقف التسليمات; تفعيل يبدأها مرة أخرى.
• سر اللفة ينشئ سرًا جديدًا. يتوقف القديم عن العمل فورًا.
• حذف يزيل نقطة النهاية. يتم الاحتفاظ بسجلها.

إعادة المحاولات والسجل

يجب أن يجيب عنوانك برمز 2xx خلال 5 ثوانٍ. لا يتم اتباع عمليات إعادة التوجيه. إذا فشل، يحاول IDup مرة أخرى بعد 1 دقيقة، 5 دقائق، 30 دقيقة، ساعتين و12 ساعة. بعد المحاولة السادسة يتم وضع علامة على التسليم تم التخلي عنه.

يعرض السجل كل محاولة مع الحدث، نقطة النهاية، المحاولة، رمز HTTP، المدة وبداية الإجابة. الحالة هي انتظار, تم التسليم, فشل أو تم التخلي عنه. استخدم إعادة الإرسال لإرسال تسليم مرة أخرى.