التحقق من توقيع webhook
كوّن السلسلة t.body من ترويسة X-CalcLib-Signature، واحسب HMAC-SHA256 باستخدام السر الخاص بك، وقارن النتيجة قبل أن تتصرف بناءً على الإرسال.
تتلقى نقطة نهاية webhook مضافة في Webhooks طلب POST موقّعًا في كل مرة يشغّل فيها أحدهم التضمين الخاص بك. يحمل كل إرسال ترويسة X-CalcLib-Signature بالصيغة t=<unix time>,v1=<signature>.
تحقق قبل التحليل
- اقرأ نص الطلب الخام. فتحليل JSON وإعادة تسلسله يغيّر البايتات، ولن يتطابق التوقيع أبدًا.
- خذ قيمة
tمن الترويسة وكوّن السلسلةt.body: الطابع الزمني ثم نقطة ثم نص الطلب الخام. - احسب HMAC-SHA256 لهذه السلسلة باستخدام سر نقطة النهاية الخاصة بك، بصيغة سداسية عشرية (hex).
- قارنه بكل قيمة
v1في زمن ثابت. وأثناء تبديل السر قد تحمل الترويسة قيمتينv1؛ ويمكن أن تتطابق أي منهما. - ارفض الإرسال إذا كان الفرق بين
tوساعتك أكثر من 5 دقائق.
عمليات الإرسال الفاشلة
تُعاد محاولتها بعد دقيقة واحدة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعتين، ثم 8 ساعات. وإذا فشلت نقطة نهاية 20 مرة متتالية فإنها تُعطَّل ونراسلك بالبريد الإلكتروني، وفق خيار المنتج في الإشعارات.