> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rntor.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# تحديد المعدل

> فهم حدود معدل API وأفضل الممارسات

## نظرة عامة

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

## حدود المعدل

| الخطة        | الطلبات في الدقيقة | الطلبات في اليوم |
| ------------ | ------------------ | ---------------- |
| Standard     | 60                 | 10,000           |
| Professional | 120                | 50,000           |
| Enterprise   | 300                | غير محدودة       |

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

تتضمن كل استجابة API رؤوساً لمساعدتك على تتبع استخدامك:

| الرأس                   | الوصف                                      |
| ----------------------- | ------------------------------------------ |
| `X-RateLimit-Limit`     | الحد الأقصى للطلبات المسموح بها في الدقيقة |
| `X-RateLimit-Remaining` | الطلبات المتبقية في النافذة الحالية        |
| `X-RateLimit-Reset`     | الطابع الزمني Unix عند إعادة تعيين الحد    |

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

```http theme={null}
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1704067200
```

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

عند تجاوز حد المعدل، ستتلقى استجابة `429 Too Many Requests`:

```json theme={null}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "retry_after": 30
  }
}
```

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

<AccordionGroup>
  <Accordion title="طبّق التراجع الأسي">
    عند تلقي استجابة 429، انتظر مدة `retry_after` المحددة قبل إعادة المحاولة. للإخفاقات اللاحقة، ضاعف وقت الانتظار.
  </Accordion>

  <Accordion title="ذاكرة التخزين المؤقت للاستجابات">
    خزّن استجابات API مؤقتاً عند الإمكان لتقليل عدد الطلبات التي تحتاج إلى إجرائها.
  </Accordion>

  <Accordion title="استخدم Webhooks">
    بدلاً من الاستطلاع للتغييرات، استخدم webhooks لتلقي إشعارات في الوقت الفعلي.
  </Accordion>

  <Accordion title="طلبات مجمَّعة">
    حيثما أمكن، استخدم نقاط نهاية مجمَّعة لتقليل العدد الإجمالي لاستدعاءات API.
  </Accordion>
</AccordionGroup>

<Info>
  هل تحتاج إلى حدود أعلى؟ تواصل مع [فريق المبيعات](mailto:sales@rntor.com) لمناقشة خطط Enterprise.
</Info>