إعداد نقاط Webhook والتحقق منها

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

يمكن لنقطة Webhook الاشتراك في أحداث انتهاء المهمة وإصدار الفاتورة واقتراب حد الحصة. تتبع النقاط سياق الحساب أو المؤسسة. يدير المالك والمسؤول نقاط المؤسسة، بينما قد يقتصر دور العضو على العرض. لا تنشئ نقطة قبل التأكد من أن النظام المستقبل قادر على استقبال الحدث والتحقق منه.

1. حدد سياق الحساب أو المؤسسة الصحيح.
2. تحقق من أن الحدث المطلوب ضمن الأنواع المعروضة.
3. تأكد من جاهزية النظام المستقبل والتحقق من التوقيع.

إنشاء نقطة عامة

أدخل اسماً من 2 إلى 120 محرفاً وعنوان HTTPS عاماً. ترفض المنظومة الوجهات الداخلية أو الخاصة لحماية التسليم. اختر الأحداث المطلوبة فقط، ثم أنشئ النقطة. قد تعرض المنظومة سر التوقيع مرة واحدة؛ انسخه مباشرة إلى مخزن الأسرار ولا تضفه إلى عنوان URL أو الشيفرة أو السجلات.

1. أدخل اسماً واضحاً وعنوان HTTPS قابل الوصول من الخدمة.
2. حدد أحداثاً يحتاجها النظام المستقبل فقط.
3. انسخ السر المعروض إلى مخزن أسرار محمي.

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

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

1. احتفظ بنسخة الحمولة الخام قبل تحليلها.
2. تحقق من التوقيع والطابع الزمني باستخدام السر.
3. سجل معرّف الحدث لمنع التكرار بأمان.

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

يعرض سجل النقطة أحدث 50 عملية تسليم وحالاتها ونتائجها. افحص رمز الاستجابة والوقت ومرجع الحدث لمعرفة سبب التعثر. أصلح النظام المستقبل قبل إعادة المحاولة؛ فقد يؤدي تكرار التسليم إلى وصول الحدث مرة أخرى، ولذلك يجب أن يكون الاستهلاك آمناً عند التكرار. لا تشارك حمولة خاصة أو سراً مع الدعم.

1. افتح سجل التسليم واختر المحاولة الفاشلة.
2. عالج سبب الفشل في النظام المستقبل.
3. أعد المحاولة وتحقق من ظهور نتيجة ناجحة.

تدوير السر واستبدال النقطة

عند تدوير السر، حدّث النظام المستقبل فوراً وتحقق من التوقيع بالسر الجديد. لا تعرض شاشة الإدارة قيمة السر القديمة مجدداً. لا يتوفر تعديل عنوان النقطة؛ أنشئ نقطة بديلة وتحقق منها ثم أوقف القديمة لتقليل الانقطاع. ألغ النقطة التي لم تعد مطلوبة.

1. نسق تحديث السر لدى النظام المستقبل.
2. أنشئ نقطة بديلة إذا احتجت إلى تغيير العنوان.
3. تحقق من التسليم ثم ألغ النقطة القديمة.

معالجة فشل التسليم

قد يفشل التسليم بسبب عنوان غير متاح أو شهادة HTTPS أو مهلة اتصال أو استجابة غير ناجحة أو توقيع غير مطابق. تحقق من إتاحة المسار والشهادة وتوافق التحقق على النظام المستقبل. لا توسع الوصول إلى وجهات داخلية ولا توقف التحقق من التوقيع لمعالجة المشكلة. استخدم مرجع الحدث ووقت المحاولة للتشخيص.

1. تحقق من العنوان العام والشهادة واستجابة النظام المستقبل.
2. قارن التحقق من التوقيع بالحمولة الخام والسر الصحيح.
3. أعد المحاولة بعد الإصلاح وأبلغ الدعم بمرجع آمن إن استمر الفشل.

الأسئلة الشائعة

صفحات ذات صلة

• افهم الأسعار قبل تقديم الطلب
• قدّم طلبات العملاء وتابعها
• عرض الاشتراكات والفوترة
• إنشاء مفاتيح API وحمايتها
• إدارة المؤسسة وأعضائها
• إدارة الإشعارات
• إدارة الملف والأمان والخصوصية