حدود المعدّل - Wave API

تفرض 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`

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

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

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