تمت ترجمة هذه الصفحة آليًا. النسخة الإنجليزية هي المصدر وقد تكون أكثر دقة أو أحدث. العرض بالإنجليزية

اختبار Webhook - أدوات لوحة التحكم والمراقبة

توفّر لوحة تحكم finlight أدوات اختبار ومراقبة شاملة لضمان عمل دمج webhook لديك بموثوقية. استخدم هذه الميزات المدمجة للتحقّق من نقاط نهاية webhook واختبارها وتصحيح أخطائها.

ملخّص

ملخّص ميزات لوحة التحكم

أدوات لوحة التحكم الرئيسية

قائمة Webhook:

  • عرض جميع عمليات webhook المُهيّأة لديك
  • رؤية الحالة (مُفعّلة/مُعطّلة) بلمحة
  • وصول سريع إلى تفاصيل webhook

صفحة تفاصيل Webhook:

  • علامة تبويب التهيئة - عرض/تعديل إعدادات webhook
  • علامة تبويب سجل الاستدعاءات - عرض جميع محاولات التسليم
  • زر الاختبار - وظيفة الاختبار اليدوي

ميزات سجل الاستدعاءات:

  • التصفية حسب الحالة - عرض النجاحات أو الإخفاقات فقط
  • سجلات مفصّلة - انقر على الإدخالات لرؤية بيانات الطلب/الاستجابة الكاملة
لوحة التحكمواجهة الإدارة

لوحة تفاصيل Webhook

ادخل إلى واجهة إدارة webhook الخاصة بك على app.finlight.me/news-webhooks لعرض جميع عمليات webhook وإدارتها.

الوصول إلى تفاصيل Webhook

  1. انتقل إلى قائمة webhook في لوحة التحكم
  2. انقر على زر «Show» الخاص بـ webhook لعرض صفحة تفاصيله
  3. اطّلع على معلومات شاملة حول تهيئة webhook وأدائه

توفّر صفحة تفاصيل webhook ما يلي:

  • نظرة عامة على التهيئة - الإعدادات الحالية ومعايير التصفية
  • سجل الاستدعاءات - سجل كامل لجميع محاولات webhook
  • عناصر تحكّم الاختبار - وظيفة الاختبار اليدوي
  • عناصر تحكّم التعديل - التعديل اليدوي بعد الإنشاء
اختبارزر الاختبار

الاختبار اليدوي

ميزة اختبار Webhook

تتضمّن لوحة التحكم زر «Test» الذي يرسل حمولة نموذجية إلى نقطة النهاية الخاصة بك:

كيفية الاستخدام:

  1. افتح صفحة تفاصيل webhook الخاصة بك
  2. انقر على زر «Test» في اللوحة العلوية
  3. انتظر بضع ثوانٍ حتى يكتمل طلب الاختبار
  4. راجع نتائج الاختبار في سجل الاستدعاءات (قد تحتاج إلى تحديث الصفحة)

ماذا يحدث:

  • يرسل حمولة نموذجية واقعية إلى نقطة النهاية المُهيّأة لديك
  • يستخدم إعدادات المصادقة الفعلية الخاصة بك
  • يتضمّن ترويسات التحقّق من التوقيع الصحيحة
  • يسجّل محاولة الاختبار في سجل الاستدعاءات الخاص بك

حمولة الاختبار: يرسل الاختبار حدث مقال وهميًا يتبع البنية نفسها لعمليات تسليم webhook الحقيقية، مما يتيح لك التحقّق من:

  • إمكانية الوصول إلى نقطة النهاية واستجابتها
  • تهيئة المصادقة
  • منطق معالجة الحمولة
  • قدرات معالجة الأخطاء
سجلسجلات التسليم

سجل الاستدعاءات والمراقبة

عرض سجل الاستدعاءات

تعرض صفحة تفاصيل webhook سجل استدعاءات شاملًا يبيّن جميع محاولات التسليم:

المعلومات المعروضة:

  • الطابع الزمني - وقت إرسال webhook
  • الحالة - نجاح (2xx) أو فشل (4xx/5xx)
  • رمز الاستجابة - رمز حالة HTTP الذي أرجعته نقطة النهاية الخاصة بك
  • زمن الاستجابة - المدة التي استغرقتها نقطة النهاية للاستجابة
  • الاستجابة - الاستجابة الكاملة (الترويسة والجسم) داخل المحتوى المنسدل عند النقر على «Show»

الطلبات الناجحة مقابل الفاشلة

الطلبات الناجحة (✅):

  • رموز حالة HTTP من 200 إلى 299
  • استلام الاستجابة ضمن فترة المهلة
  • إقرار سليم من نقطة النهاية الخاصة بك

الطلبات الفاشلة (❌):

  • رموز حالة HTTP من 400 إلى 599
  • مهلات الشبكة أو أخطاء الاتصال
  • إخفاقات المصادقة
  • عناوين URL غير صالحة لنقطة النهاية
تصحيحاستكشاف الأخطاء

التصحيح باستخدام لوحة التحكم

استخدام سجل الاستدعاءات للتصحيح

سجل الاستدعاءات هو أداتك الأساسية لتشخيص مشكلات webhook:

تحديد الأنماط:

  1. التصفية حسب الحالة - اعرض الطلبات الفاشلة فقط لتحديد المشكلات
  2. فحص الطوابع الزمنية - ابحث عن أنماط زمنية في الإخفاقات
  3. مراجعة رموز الاستجابة - افهم ما تُرجعه نقطة النهاية الخاصة بك
  4. فحص محاولات إعادة المحاولة - اطّلع على عدد مرات محاولة التسليم

مؤشّرات الفشل الشائعة:

  • HTTP 401/403 - مشكلات مصادقة أو تفويض
  • HTTP 404 - عنوان URL غير صحيح لنقطة النهاية
  • HTTP 500 - أخطاء خادم داخلية في تطبيقك
  • المهلات - تستغرق نقطة النهاية وقتًا طويلًا جدًا للاستجابة
  • أخطاء الاتصال - مشكلات في اتصال الشبكة

معلومات الخطأ المفصّلة

انقر على أي إدخال في سجل الاستدعاءات لرؤية:

  • ترويسات الطلب الكاملة المُرسلة إلى نقطة النهاية الخاصة بك
  • ترويسات الاستجابة المستلمة من نقطة النهاية الخاصة بك
  • محتوى جسم الاستجابة (إن وُجد)
  • معلومات التوقيت الدقيق
  • سجل إعادة المحاولة للمحاولات الفاشلة
متطلباتإرشادات التنفيذ

متطلبات نقطة النهاية

متطلبات الاستجابة

يجب أن تستوفي نقطة نهاية webhook الخاصة بك ما يلي:

استجابة HTTP:

  • إرجاع رموز الحالة 200-299 للمعالجة الناجحة
  • الاستجابة خلال 30 ثانية لتجنّب المهلات
  • قبول طلبات POST بحمولات JSON

الترويسات:

  • معالجة X-Webhook-Signature للتحقّق من التوقيع
  • التعامل مع X-Webhook-Timestamp لمنع هجمات إعادة التشغيل
  • دعم ترويسات طريقة المصادقة التي اخترتها

للحصول على إرشادات إعداد webhook، راجع وثائق webhook الرئيسية. وللاطّلاع على تفاصيل المصادقة، راجع دليل المصادقة.