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

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

> حدود الطلبات والـ headers التي تُعيدها Wave.

تفرض Wave حدًّا على معدّل طلبات الـ API يبلغ 60 طلبًا في الدقيقة لكلّ key (نافذة متحرّكة مدّتها 60 ثانية). وتجاوزه يُعيد `429` مع `error_code: RATE_LIMIT_EXCEEDED` ضمن غلاف الخطأ القياسيّ.

## الـ Headers

تتضمّن كلّ استجابة حالة حدّ المعدّل الحاليّة:

| الـ Header              | الوصف                                                    |
| ----------------------- | -------------------------------------------------------- |
| `x-ratelimit-limit`     | الحدّ الأقصى للطلبات في النافذة (`60`).                  |
| `x-ratelimit-remaining` | الطلبات المتبقّية في النافذة.                            |
| `x-ratelimit-reset`     | الثواني حتّى إعادة تعيين النافذة.                        |
| `retry-after`           | (عند `429`) الثواني المطلوب انتظارها قبل إعادة المحاولة. |

## التعامل مع `429`

تراجَع وأعِد المحاولة بعد إعادة تعيين النافذة:

```javascript theme={null}
if (res.status === 429) {
  const wait = Number(res.headers.get("retry-after") ?? 1) * 1000;
  await new Promise((r) => setTimeout(r, wait));
  // retry…
}
```

<Note>
  ينطبق حدّ 60/الدقيقة على الـ sandbox keys اليوم. وقد تحصل فئات الإنتاج على حدود أعلى عند إطلاق مسار الترقية.
</Note>