مرجع API · إشعارات Webhook

اختبار استقبال الإشعارات

اطلب من أنيس إرسال إشعار اختبار موقّع إلى عنوانك المتحقق منه. لا ينشئ الاختبار عملية شراء.

• وقّع بصمة المحتوى برقم استخدام واحد جديد، دون Idempotency-Key. لا ينشئ هذا التغيير عملية شراء.

الاستدعاء

موقَّع بمفتاحك، مع رقم استخدام لمرة واحدة (nonce) وبصمة للمحتوى.

الترويسات: Signature-Input، Signature، Content-Digest، Nonce، X-Anis-Date، Accept-Language (اختياري). تضبطها حزم SDK كلها نيابةً عنك.

المحتوى: البايتان {} بالضبط.

الردود

كل ردّ على هذا الاستدعاء موقَّع من أنيس — النجاح وكل رفض. اشترط وجود التوقيع وتحقّق منه قبل أن تتصرف بناءً على الردّ؛ والردّ بلا توقيع فشل، لا يُعدّ ردًّا (كيف).

حالات الرفض

كل رفض لهذا الاستدعاء مشكلةٌ موقَّعة. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.

الأنواع