تحذير
ZATCA-00025 تجاوز حد معدل الطلبات
تم إرسال طلبات API كثيرة جداً لزاتكا في فترة قصيرة. يفرض النظام تحديد المعدل لمنع الحمل الزائد.
⚠️ ما سبب هذا الخطأ؟
الأسباب الشائعة لظهور ZATCA-00025
- ✗ إرسال فواتير بالجملة بسرعة كبيرة بدون تنظيم
- ✗ منطق إعادة المحاولة يرسل طلبات مكررة بدون تأخير
- ✗ وحدات EGS متعددة تصل لنفس نقطة وصول زاتكا في وقت واحد
- ✗ عدم تطبيق تنظيم الطلبات في كود التكامل
✅ كيف تحل هذا الخطأ
اتبع هذه الخطوات لحل ZATCA-00025
1
طبّق التراجع الأسّي
انتظر تدريجياً أطول بين إعادة المحاولات: ثانيتان، 4 ثوانٍ، 8 ثوانٍ، وهكذا.
2
أرسل بالدفعات مع تأخير
أضف تأخيراً بين تقديم الفواتير عند معالجة فواتير بالجملة.
3
تحقق من ترويسات حد المعدل
راقب ترويسات الاستجابة X-RateLimit-Remaining لمعرفة اقترابك من الحد.
حل أخطاء زاتكا تلقائياً
قيمة تتحقق من الفواتير قبل الإرسال وتمنع أخطاء ZATCA-00025 من الحدوث.