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

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

> كيف تعمل حدود الطلبات وكيفية التعامل معها.

كل مفتاح API له حد معدّل لكل دقيقة. تتمتع مفاتيح الإنتاج بسقف أعلى من مفاتيح
بيئة الاختبار؛ ويتجاوز الحدُّ المُحدَّد صراحةً لكل مفتاح في لوحة التحكم الحدَّ
الافتراضي.

| البيئة                     | الحد الافتراضي    |
| -------------------------- | ----------------- |
| الإنتاج (`tg_live_`)       | 1,000 طلب / دقيقة |
| بيئة الاختبار (`tg_test_`) | 100 طلب / دقيقة   |

## ترويسات الاستجابة

تتضمن كل استجابة وضعك الحالي في النافذة الزمنية:

| الترويسة                | المعنى                                              |
| ----------------------- | --------------------------------------------------- |
| `X-RateLimit-Limit`     | الحد الأقصى للطلبات المسموح بها في النافذة          |
| `X-RateLimit-Remaining` | الطلبات المتبقية في النافذة الحالية                 |
| `Retry-After`           | عدد الثواني التي يجب الانتظارها (يظهر فقط مع `429`) |

## عند تجاوز الحد

ستتلقى `429 Too Many Requests`:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "API key rate limit exceeded",
    "details": { "limit": 1000, "window": "1 minute", "retry_after_seconds": 60 }
  }
}
```

<Tip>
  تراجع وأعد المحاولة بعد عدد الثواني المحدد في `Retry-After`، ويُفضّل ذلك مع
  تراجع أُسي وعشوائية. وزّع الأعمال المجمّعة على فترات بدلاً من إرسالها دفعة واحدة.
</Tip>