استخدام واجهة برمجة تطبيقات البلاغات وخطافات الويب الموقعة

ادمج سجلات البلاغات باستخدام بيانات اعتماد محددة النطاق، وتسليم موقّع، وإمكانية رؤية عمليات إعادة المحاولة.

اربط الأنظمة الموثوقة ببيانات اعتماد API محددة النطاق وتسليم موقّع عبر Webhook.

قبل البدء

  • حدّد التكامل الموثوق ومستقبِل HTTPS.
  • جهّز تخزينًا آمنًا للأسرار ومعالجةً لإعادة المحاولة.
إعدادات اتصال Issue مع عناصر تحكم برمز API وحقول نقطة النهاية وWebhook الموقّع.
يحصر الاتصال بيانات الاعتماد في مثيل واحد ويعرض حالة تسليم Webhook لأغراض التشخيص.

حماية بيانات اعتماد API

فعّل API وأنشئ رمزًا للتكامل الموثوق فقط. يظهر الرمز مرة واحدة؛ ويؤدي تدويره إلى إبطال بيانات الاعتماد السابقة.

استخدم التزامن والنطاق

يسرد API السجلات وينشئها ويقرأها ويحدّثها ويغيّر حالتها داخل المثيل ذي الـ public-slug فقط. أرسل إصدار القفل الحالي عند التحديث لاكتشاف عمليات الكتابة القديمة.

التحقق من تسليم Webhook

اضبط مستقبِل HTTPS وسرًا. تُوقّع عمليات التسليم وتظل المحاولات ظاهرة لأغراض التشخيص. إن Webhook إشعار، وليس دليلًا على أن النظام البعيد عالج الحدث.

خطوة بخطوة

  1. افتح الاتصال من الإعدادات.
  2. فعّل API لمستهلك موثوق فقط.
  3. أنشئ الرمز أحادي الاستخدام وخزّنه بأمان.
  4. اضبط عنوان URL لـ HTTPS Webhook والسر.
  5. تحقق من التوقيعات وإعادات المحاولة وسجل التسليم.

التحقق النهائي

  • يُخزّن الرمز خارج السجلات ولقطات الشاشة.
  • ترسل التحديثات إصدار القفل الحالي.
  • يتحقق المستقبِل من كل توقيع.
نصيحة: يثبت تسليم Webhook نجاح النقل، لا إتمام النظام البعيد لمعالجته الخاصة.