Rate Limiting

تحديد المعدل (Rate Limiting) هو آلية حماية تقيّد عدد طلبات API ضمن نافذة زمنية محددة، لضمان الاستخدام العادل والحفاظ على استقرار النظام. عند تجاوز الحد، تحصل على استجابة HTTP 429 مع ترويسة Retry-After.

ما هو تحديد المعدل؟

تحديد المعدل (Rate Limiting) آلية للتحكم في حركة المرور تضبط عدد طلبات API التي يمكن لعميل واحد (يُعرَّف بمفتاح API أو عنوان IP) إرسالها ضمن نافذة زمنية محددة – مثلاً 100 طلب في الدقيقة أو 10,000 رسالة في اليوم. تحمي هذه الحدود البنية التحتية للواجهة من التحميل الزائد وتضمن وصولاً متكافئاً لجميع العملاء. فبدون تحديد المعدل، قد يُطلِق روبوت واحد معطوب آلاف الطلبات في الثانية ويُبطئ الخدمة على الجميع.

تقنياً، يُنفَّذ تحديد المعدل غالباً عبر خوارزميات Token Bucket أو Sliding Window. لكل مفتاح API "رصيد" من الطلبات يتجدد باستمرار. مع كل طلب تُرسله يُستهلَك رمز (token). وعند نفاد جميع الرموز، عليك الانتظار حتى يُعاد ملؤها. تستخدم SendSeven نظاماً عادلاً وشفافاً برسائل خطأ واضحة وإرشادات لإعادة المحاولة.

لماذا تُوجد حدود المعدل؟

استقرار النظام: تتشارك الواجهات الموارد (المعالج، قاعدة البيانات، الشبكة). قد يُعطّل عميل "سيّئ" واحد النظام بأكمله دون حدود – ويمنع تحديد المعدل مثل هذه السيناريوهات من نوع حجب الخدمة.

الاستخدام العادل: ينبغي أن يستفيد جميع العملاء بالتساوي. فإذا استهلك عميل واحد 90% من السعة، تضرّر الآخرون. تضمن حدود المعدل الإنصاف.

التحكم في التكلفة: قد تُطلق الحلقات اللانهائية العَرَضية في شيفرتك ملايين الطلبات دون حدود – وتُسبّب تكاليف مقابلة. يعمل تحديد المعدل كمكبح طوارئ.

الحماية من إساءة الاستخدام: غالباً ما يحاول مرسلو الرسائل المزعجة والمهاجمون إغراق الواجهات. تجعل حدود المعدل هذه الهجمات غير مجدية اقتصادياً وقابلة للكشف.

التعامل مع استجابات HTTP 429

عند تجاوز حد المعدل، تردّ الواجهة بالرمز HTTP 429 (Too Many Requests). تحتوي ترويسة الاستجابة على معلومات مهمة:

HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1676543210

Retry-After: عدد الثواني التي يجب الانتظار قبل السماح بالطلب التالي.

X-RateLimit-Limit: حدك الإجمالي (مثلاً 100 طلب في الدقيقة).

X-RateLimit-Remaining: عدد الطلبات المتبقية المتاحة (هنا: 0).

X-RateLimit-Reset: طابع زمني Unix لموعد إعادة ضبط الحد.

تُطبّق التطبيقات الاحترافية التراجع الأسّي (Exponential Backoff): بعد خطأ 429، لا تنتظر 60 ثانية ثابتة فحسب، بل تُضاعف مدة الانتظار مع كل خطأ إضافي (1 ثانية، 2، 4، 8، ...). يمنع ذلك مشكلات "اندفاع القطيع" (Thundering Herd) حيث يُعيد آلاف العملاء المحاولة في وقت واحد فيُحمّلون النظام من جديد.

حدود المعدل في SendSeven

تستخدم SendSeven حدود معدل عادلة وسخية تكفي للغالبية العظمى من حالات الاستخدام. القيم النموذجية (بحسب باقتك):

• طلبات API: 100 طلب في الدقيقة (لعمليات القراءة)
• إرسال الرسائل: 1,000 رسالة في الساعة (حماية من الرسائل المزعجة)
• تسليمات Webhook: 10 اتصالات متوازية

تجد الحدود الدقيقة في توثيق الواجهة على docs.sendseven.com. وإذا احتجت حدوداً أعلى (مثلاً للاستيرادات الكبيرة أو الحملات التي تستهدف أكثر من 100,000 مستلم)، تواصَل مع الدعم – فالتعديلات الفردية ممكنة.

أفضل ممارسة: طبّق تحديد المعدل من جانب العميل داخل تطبيقك مسبقاً. استخدم قوائم الانتظار (مثل Bull لـ Node.js وCelery لـ Python) لمعالجة الطلبات بشكل مُتحكَّم به – بهذا تتجنّب أخطاء 429 من الأساس وتُحسّن التكاليف.