الانتقال إلى المحتوى الرئيسي

نظرة عامة

تطبّق Rntor API تحديد المعدل لضمان الاستخدام العادل والحفاظ على جودة الخدمة لجميع المستخدمين.

حدود المعدل

الخطةالطلبات في الدقيقةالطلبات في اليوم
Standard6010,000
Professional12050,000
Enterprise300غير محدودة

رؤوس حدود المعدل

تتضمن كل استجابة API رؤوساً لمساعدتك على تتبع استخدامك:
الرأسالوصف
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقة
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-Resetالطابع الزمني Unix عند إعادة تعيين الحد

مثال على رؤوس الاستجابة

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1704067200

معالجة حدود المعدل

عند تجاوز حد المعدل، ستتلقى استجابة 429 Too Many Requests:
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "retry_after": 30
  }
}

أفضل الممارسات

عند تلقي استجابة 429، انتظر مدة retry_after المحددة قبل إعادة المحاولة. للإخفاقات اللاحقة، ضاعف وقت الانتظار.
خزّن استجابات API مؤقتاً عند الإمكان لتقليل عدد الطلبات التي تحتاج إلى إجرائها.
بدلاً من الاستطلاع للتغييرات، استخدم webhooks لتلقي إشعارات في الوقت الفعلي.
حيثما أمكن، استخدم نقاط نهاية مجمَّعة لتقليل العدد الإجمالي لاستدعاءات API.
هل تحتاج إلى حدود أعلى؟ تواصل مع فريق المبيعات لمناقشة خطط Enterprise.