سجلات التسليم والاختبار
تضم إعدادات الويب هوك سجل تسليم لكل وجهة. تحقق به من وصول الأحداث وشخّص الإخفاقات وأرسل عينة جديدة دون نشاط فعلي.
عرض سجلات التسليم
1
افتح الإعدادات ← Webhooks
انتقل إلى
Dashboard → Settings → Webhooks.2
وسّع صف webhook
انقر على سجلات التسليم على بطاقة Webhook. تظهر آخر 50 محاولة بدءًا بالأحدث.
3
افحص كل إدخال
يعرض كل صف نوع الحدث ورمز حالة HTTP ووقت الاستجابة والطابع الزمني وأي رسالة خطأ.
حقول السجل
| حقل | الوصف |
|---|---|
| الحدث | نوع الحدث الذي أُطلق (مثل post.saved) |
| الحالة | حالة HTTP التي تعيدها نقطة النهاية لديك. null إذا انتهت المهلة أو رُفض الاتصال. |
| زمن الاستجابة | زمن الرحلة ذهابًا وإيابًا بالمللي ثانية، من الإرسال حتى آخر بايت في الاستجابة. |
| نجاح | علامة صح خضراء = HTTP 2xx. علامة خطأ حمراء = أي نتيجة أخرى. |
| خطأ | رسالة خطأ مفهومة للبشر لعمليات التسليم الفاشلة (مثل Request timed out (10s)). |
| وقت التسليم | وقت محاولة التسليم بتوقيت UTC. |
إرسال حدث تجريبي
1
وسّع بطاقة webhook
في
Settings → Webhooks، وابحث عن webhook الخاص بك وانقر على إرسال حدث تجريبي.2
راجع سجل التسليم
يظهر التسليم التجريبي أعلى سجل التسليم خلال ثوانٍ. تأكد من ظهور
200 الحالة.الأحداث التجريبية طلبات HTTP حقيقية
يمر الحدث التجريبي بالمسار نفسه تمامًا للحدث الفعلي، بما فيه توقيع HMAC. يُختبر كود التحقق من التوقيع كاملًا.
لا إعادة محاولة تلقائية
تُجرى محاولة واحدة لكل تسليم. السجل للتشخيص فقط؛ لا يوجد زر لإعادة إرسال حدث مباشر فشل تسليمه. بعد إصلاح نقطة النهاية، استخدم «اختبار» للتحقق من الإصلاح.
أسباب الفشل الشائعة
| الخطأ / الحالة | السبب المحتمل | إصلاح |
|---|---|---|
Request timed out (10s) | استغرق الخادم أكثر من 10 ثوانٍ للرد | عودة 200 فورًا، ثم عالج الطلب بصورة غير متزامنة |
401 | فشل التحقق من التوقيع | تأكد من قراءة جسم الطلب الخام قبل تحليل JSON |
404 | مسار عنوان URL لنقطة النهاية غير موجود | تحقق مرة أخرى من عنوان URL في إعدادات Webhooks في Savebase |
500 | خطأ غير معالج في مستقبِلك | راجع سجلات الخادم للعثور على الاستثناء |
| رُفض الاتصال / الحالة null | الخادم متوقف أو الرابط خاطئ | تحقق من تشغيل الخادم وإتاحته للعامة |