القسم الحالي: حدود الطلبات

حدود الطلبات

تُحدد معدلات الوصول إلى API حسب باقتك. يوجد نوعان من الحدود: الحصة اليومية وحد الذروة (burst) لكل دقيقة.

مقارنة الباقات كاملة

الباقةالحد اليوميحد الذروةمفاتيح APIWebSocketWebhooks للأحداثقواعد الأحداث
Free100/day10/min100
Starter5,000/day100/min300
Pro50,000/day500/min10310
Business150,000/day1,000/min301050
Enterpriseمخصصمخصصمخصصمخصصمخصص

الحصص اليومية مشتركة على مستوى الحساب، بما في ذلك مفاتيح Live وTest. لا يؤدي تدوير المفتاح أو إلغاؤه إلى إنشاء حصة يومية جديدة.

الحماية من الذروة: لمنع إساءة الاستخدام وحماية الاستقرار، يُطبق حد الدقيقة على مستوى مفتاح API والحساب معاً. تعيد الطلبات التي تتجاوز الحدود HTTP 429. تُصفّر الحدود اليومية عند منتصف الليل بتوقيت Asia/Riyadh ‏(UTC+3). تعتمد حدود Enterprise على العقد، وقد تكون حصصاً شهرية أو مرتبطة بالموارد.

ترويسات حدود الطلبات

تتضمن معظم استجابات /api/v1/* الناجحة X-RateLimit-Limit, X-RateLimit-Remaining، و X-RateLimit-Reset.

X-RateLimit-Reset هو طابع Unix الزمني لمنتصف الليل التالي بتوقيت Asia/Riyadh. تُفرض الحصة اليومية على الحساب كله وعبر جميع المفاتيح. لكن X-RateLimit-Remaining يُحسب حالياً من المفتاح المستخدم للطلب، ولذلك قد يكون أعلى من الحصة الحقيقية المتبقية للحساب عند استخدام عدة مفاتيح.

قد تحذف الوكلاء الطرفية الترويسات. استخدم HTTP 429 وقيمة الاستجابة detail، و Retry-After عند توفرها بوصفها عقد الحد البديل.

آخر تحديث في