مركز المساعدةمركز المساعدة / المطورون · مفهوم
كيف تُرسل رسالة Webhook المتجر، وما الذي يُعدّ استلامًا، ومتى تُعاد المحاولة، وكيف تتحقق من التوقيع.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
ابنِ المستقبِل لديك ليردّ بسرعة، ويقبل التكرار، ويتحقق مما يستلمه. هذه الصفحة تعرض قواعد التسليم بدقة.
| الخاصية | القيمة |
|---|---|
| الطريقة | POST |
| المحتوى | JSON فيه event وdata. راجع الأحداث وبياناتها |
| الترويسات | Content-Type: application/json وSignature |
| TLS | يُتحقق من شهادة العنوان الذي يبدأ بـ https://. الشهادة غير الصالحة تُفشل التسليم |
| مهلة الرد المسموحة | 3 ثوانٍ |
أي رد بحالة 2xx. أي حالة نهائية أخرى، أو انتهاء المهلة، أو فشل الاتصال، يُعدّ فشلًا.
رُدّ بـ 200 فور تخزين الرسالة. نفّذ العمل البطيء بعد ذلك.
| المحاولة | متى |
|---|---|
| 1 | عند وقوع الحدث |
| 2 | بعد 10 ثوانٍ من الفشل الأول |
| 3 | بعد 100 ثانية من الفشل الثاني |
بعد الفشل الثالث تُهمل الرسالة. لا شيء يسجّلها ولا يُبلَّغ أحد. ليس في اللوحة سجل تسليم ولا إعادة إرسال.
خطّط لذلك:
data لتجاهل التكرار.كل طلب يحمل ترويسة Signature. وهي قيمة HMAC-SHA256 لمحتوى الطلب بالنظام الست عشري وبأحرف صغيرة، ومفتاحها مفتاح التوقيع السري.
للتحقق من رسالة:
Signature بمقارنة ثابتة الزمن. ارفض الرسالة إذا اختلفتا.لا تحلّل JSON ثم تعيد تسلسله قبل الحساب. أي تغيير في المسافات أو في ترميز الأحرف يعطي نتيجة مختلفة.
اللوحة لا تعرض مفتاح التوقيع السري. اطلب مفتاح التوقيع السري من الدعم.
ممارسات جيدة لأي مستقبِل:
https:// وأبقِه خاصًّا.أنشئ Webhook يشير إلى أداة لفحص الطلبات، وحدّد حدثًا واحدًا، ثم أحدِثه في المتجر. بطاقة ماذا نرسل في النموذج تعرض طريقة الطلب واسم الترويسة ومهلة الرد وعدد المحاولات.