الانتقال إلى المحتوى الرئيسي
تفرض 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 اليوم. وقد تحصل فئات الإنتاج على حدود أعلى عند إطلاق مسار الترقية.