ما هو
مكتب فرز مجاني لتسليمات الويب هوك الفاشلة. يقرأ سجلًا عاديًا ويحوّله إلى قائمة واضحة من القضايا والأسباب والخطوات التالية.
فرز أعطال الويب هوك
لكل ويب هوك فشل تشريحٌ يكشف السبب.
الصق سجل التسليم من Stripe أو GitHub أو Shopify أو من طابورك الخاص. يضع Webhook Morgue على كل فشل بطاقة بسببه، ويخبرك بما يمكن إعادة إرساله بأمان، ويبني خطة إعادة بفترات انتظار معقولة.
لمن هو
للمطورين ومهندسي المناوبة الذين يستقبلون إشعارات من منصات الدفع أو التجارة أو الشيفرة ويحتاجون إلى قرار سريع بشأن ما يُعاد إرساله.
ماذا يحل
إعادة المحاولة العمياء. إعادة إرسال 401 أو 410 لا تصنع إلا أعطالًا جديدة، بينما يكفي الخطأ 500 أو انتهاء المهلة غالبًا إعادة هادئة. هذه الأداة تفرّق بينهما.
ملف القضية
تسليم واحد في كل سطر. افصل بين الحدث ورمز الحالة والملاحظة بخط عمودي، أو الصق أسطر JSON.
مثال على سطر: invoice.paid | 500 | upstream timeout | 14:02
لا قضايا بعد
حمّل السجل التجريبي لترى تشريحًا كاملًا لثمانية تسليمات، أو الصق سجلك.
يُقرأ السجل داخل متصفحك. لا يُرفع أي شيء.
فحص التوقيع
معظم أخطاء 401 سببها توقيع غير مطابق. الصق جسم الطلب الخام ومفتاح التوقيع وترويسة التوقيع لترى إن كانت متطابقة.
استخدم مفتاحًا تجريبيًا. يجري الفحص في متصفحك ولا يغادر المفتاح هذه الصفحة.
يُحسب HMAC SHA 256 عبر Web Crypto API داخل متصفحك.
أسباب الوفاة
ما يعنيه كل فشل عادةً وما الذي تفعله حياله.
انتهت المهلة
أعد الإرسال بفترات متزايدة. اجعل المعالج يرد خلال ثوانٍ قليلة وانقل العمل البطيء إلى طابور.
تعطّل المستقبِل
أعد الإرسال بفترات متزايدة بعد أن يتعافى المستقبِل. راجع سجل أخطائه لهذا الحدث.
تجاوز حد الطلبات
انتظر المدة التي طلبها المستقبِل، ثم أعد الإرسال ببطء.
رُفض التوقيع أو الصلاحية
لا تُعِد الإرسال الآن. تحقق من مفتاح التوقيع لدى الطرفين، ثم أعد الإرسال مرة واحدة.
نقطة النهاية غير موجودة
لا تُعِد الإرسال. وجّه الويب هوك إلى نقطة النهاية الجديدة أو ألغِ الاشتراك.
رُفض المحتوى
لا تُعِد الإرسال كما هو. أصلح المعالج أو المخطط، ثم أعد الإرسال مرة واحدة.
أُعيد توجيهه
لا ينبغي للمستقبِل أن يعيد التوجيه. حدّث عنوان الويب هوك إلى العنوان النهائي.
وصل
لا شيء مطلوب. وصل هذا التسليم.
طريقة الاستخدام
صدّر السجل
انسخ التسليمات الفاشلة من لوحة المزوّد أو من طابورك. اسم الحدث ورمز الحالة يكفيان.
ابدأ التشريح
يتحول كل سطر إلى قضية ببطاقة وسبب وفاة وخطوة تالية واضحة.
اتبع الخطة
أعد إرسال القضايا الآمنة وفق الجدول المقترح، وأصلح البقية أولًا، ثم شارك التقرير مع فريقك.
ما لا تفعله الأداة
- لا تتصل بمزوّدك ولا تعيد إرسال أي شيء نيابة عنك. تخبرك بما يُعاد إرساله ومتى.
- لا ترى ما يجري داخل المستقبِل. الخطأ 500 يعني أن شيفرتك فشلت، والسجل وحده لا يقول السبب.
- تقرأ الصيغ المعروضة هنا فقط. قد تحتاج السجلات غير المعتادة إلى تنظيف سريع أولًا.
أسئلة
هل يُرسل سجلي إلى أي مكان؟
لا. التحليل والخطة وفحص التوقيع كلها تعمل داخل متصفحك.
لماذا لا نعيد إرسال كل شيء؟
إعادة إرسال 401 أو 404 أو 422 تفشل مجددًا بالطريقة نفسها وقد تطلق تنبيهات أو حظرًا. أصلح السبب أولًا ثم أعد الإرسال مرة واحدة.
لماذا فترات الانتظار غير متساوية؟
إزاحة عشوائية صغيرة تسمى jitter تمنع المحاولات الكثيرة من ضرب الخادم المتعافي في الثانية نفسها.