الترويسات
ردود JSON الناجحة (200) والرد 429 تحمل حالة النافذة:
رد
text/event-stream الخاص بنقطة نهاية الرد المتدفق وأغلفة الأخطاء الأخرى (401، 403، 404، 409، 422، 503، 500) لا تحمل هذه الترويسات؛ الترويسة X-Request-ID وحدها موجودة في كل رد. إذا كنت تضبط وتيرة عميلك على X-RateLimit-Remaining، فعامل الترويسة المفقودة على أنها «غير معروفة» لا صفرًا.
عندما تُستنفد النافذة تجيب API بـ 429 rate_limit_exceeded وتضيف Retry-After (الثواني حتى إعادة النافذة).
عندما يتوقف المحدّد نفسه
المحدّد يفشل بالإغلاق. إذا كان مخزنه غير متاح، تجيب API بـ503 api_rate_limit_unavailable مع Retry-After: 5 بدلًا من تمرير الطلبات بلا قياس، وبدلًا من 429 مضلل. عامله كأي خطأ عابر آخر: انتظر ثم أعد المحاولة بنفس Idempotency-Key.