⏱️ معدلات الطلبات والحدود

📌 ما هي معدلات الطلبات؟

لتوزيع الموارد بشكل عادل، يحدّ Omdaa API عدد الطلبات المسموح بها لكل دقيقة (و/أو لكل ساعة) حسب نوع الحساب والخطة. عند تجاوز الحد، يُرجع الخادم رمز الحالة 429 Too Many Requests.

📊 حدود عامة (مثال توضيحي)

قد تختلف القيم الفعلية حسب خطتك. راجع لوحة التحكم أو التوثيق الرسمي للقيم المحدثة.

• طلبات القراءة (GET): عادةً 60–120 طلب/دقيقة لكل مفتاح API أو JWT.
• طلبات الكتابة (POST/PUT/DELETE): عادةً 30–60 طلب/دقيقة.
• إرسال الرسائل: قد يكون لها حد منفصل (مثلاً 80 رسالة/ثانية حسب سياسة واتساب).

📋 رؤوس الاستجابة (Rate Limit Headers)

قد يُرجع API رؤوساً تساعدك على معرفة الحد المتبقي ووقت إعادة التعيين:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640000000
Retry-After: 42

Retry-After يظهر عادةً مع الاستجابة 429 ويحدد بالثواني متى يمكن إعادة المحاولة.

⚠️ التعامل مع 429

عند استلام 429:

1. اقرأ رأس Retry-After إن وُجد وانتظر المدة المحددة.
2. إن لم يُرجع الرأس، استخدم تأخيراً تصاعدياً (مثلاً 1 ثانية ثم 2 ثم 4...).
3. تجنب إعادة إرسال الطلب فوراً بدون انتظار لتجنب تفاقم الحظر.