كيفية استخدام مختبِر Webhook
- اضغط «إنشاء عنوان URL للالتقاط» وانسخ العنوان.
- اضبطه وجهةً لطلبات webhook لدى مزوّدك (أو أرسل طلباً باستخدام cURL / الأمر النموذجي).
- انتظر لحظة — تظهر عمليات التسليم في القائمة؛ انقر على إحداها لفحصها.
- استخدم تبويب «إعادة الإرسال» (Replay) لإنشاء أمر cURL يعيد إرسال التسليم إلى خادمك.
- احذف نقطة النهاية عند الانتهاء (أو دع صلاحيتها تنتهي).
مزايا مختبِر Webhook
- عنوان URL فريد للالتقاط يُنشأ بنقرة واحدة، ويُحفظ عبر تحديث الصفحة، وتنتهي صلاحيته بعد 24 ساعة
- استعلام دوري (polling) مباشر كل 3 ثوانٍ ما دام التبويب مرئياً؛ وحالة فارغة تعرض «في انتظار طلب وارد…»
- قائمة طلبات بالطريقة والمسار والوقت والحجم؛ وعرض تفصيلي بملخّص وترويسات مجمّعة وجسم (JSON/نموذج/خام/شجرة) واستعلام وHTTP خام وإعادة إرسال
- اكتشاف المزوّد (Stripe وGitHub وShopify وSlack وTwilio وPayPal وGitLab وBitbucket…) مع نوع الحدث وترويسة التوقيع
- استخراج الحقول المهمة والطوابع الزمنية، ونسخ الحمولة/الترويسات/أمر cURL، وتصدير جميع الالتقاطات بصيغة JSON
- زر إرسال طلب اختباري، وفتح في تبويب جديد، ومسح الالتقاطات، وحذف نقطة النهاية مع عدّ تنازلي لانتهاء الصلاحية
مثال على مختبِر Webhook
التقاط حدث من Stripe
الإدخال:
Stripe → POST https://www.mutqansoft.sa/api/v1/webhooks/in/3f9c…
Stripe-Signature: t=1725184801,v1=…
{"id":"evt_1PZx…","type":"payment_intent.succeeded",…}النتيجة:
POST / 12:00:01.120 1.4 KB
Provider: Stripe (high confidence) · Event: payment_intent.succeeded · Signature header: Stripe-Signature
Important fields: $.data.object.amount 19900 (199.00 if minor units) · $.data.object.created 1725184790 → 2024-09-01T10:39:50Zالأسئلة الشائعة حول مختبِر Webhook
كم تدوم صلاحية عنوان URL الخاص بي؟
تنتهي صلاحية نقاط نهاية الالتقاط تلقائياً بعد 24 ساعة. ويُحفظ عنوان URL في جلسة متصفحك فيبقى بعد تحديث الصفحة؛ استخدم «حذف نقطة النهاية» لإزالته قبل ذلك.
ما سرعة ظهور الطلبات؟
تستعلم الصفحة كل 3 ثوانٍ ما دام التبويب مرئياً وتتوقف عندما يكون مخفياً، لذا تظهر عمليات التسليم فوراً تقريباً دون إهدار للطلبات.
ما الذي يُلتقط؟
الطريقة والمسار وسلسلة الاستعلام وجميع الترويسات والجسم الخام (تُعرض أجسام JSON والنماذج مفكوكة الترميز أيضاً) والحجم وعنوان IP للعميل والوقت الدقيق للاستلام. وتُقتطع الأجسام التي تتجاوز حدّ المُرحِّل مع الإشارة إلى ذلك.
هل يمكنني إعادة إرسال تسليم إلى خادمي؟
نعم — ينشئ تبويب إعادة الإرسال أمر cURL موجّهاً إلى عنوان URL الذي تدخله، مع الاحتفاظ بترويسات المزوّد والتوقيع حتى يمكن اختبار كود التحقق لديك.
هل تستجيب نقطة النهاية للمزوّد؟
تردّ بالحالة 200 OK مع جسم JSON صغير، وهو ما يلبّي فحوصات التسليم لدى معظم المزوّدين.
ملاحظات تقنية
ينشئ المتصفح نقطة النهاية عبر POST /api/v1/webhooks، ويحتفظ بالمعرّف/الرمز في sessionStorage، ويستعلم دورياً عبر GET /api/v1/webhooks/:id/requests?after=<last timestamp> مع ترويسة X-Webhook-Token. ويتباطأ الاستعلام الدوري عند حدوث أخطاء ويتوقف عندما يكون التبويب مخفياً.