Too Many Requests

too-many-requests · 429

أرسل صاحب النداء إلى هذا المسار طلبات أكثر مما تسمح به نافذته، فرفضت الـ API هذا الطلب دون أن تنفذه.

كل الصفحات

كل مسار يعد الطلبات من كل عنوان IP للعميل على حدة: 100 في الدقيقة عادة. ويستحق إعادة المحاولة، بعد الانتظار الذي يسميه الجواب.

لا يضيف هذا النوع شيئا إلى الحقول التي في كل خطأ.

الأسباب الشائعة

  • حلقة استعلام دون تأخير بين دورة وأخرى.
  • حلقة إعادة محاولة تعد كل فشل قابلا للإعادة، فتتسارع حتى تبلغ الحد.
  • عدة workers خلف عنوان IP واحد ينادون المسار نفسه.

كيف تصلح الطلب

  • انتظر عدد الثواني الذي في الـ header Retry-After، ثم أعد المحاولة.
  • ضع تأخيرا في كل حلقة استعلام، وأطله عندما لا يتغير الجواب.
  • وزع العمل المتوازي على وقت أطول بدل أن ترسله كله دفعة واحدة.

مثال على الرد

json
{
  "type": "too-many-requests",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "ThrottlerException: Too Many Requests",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects",
  "method": "GET",
  "instance": "GET /v1/projects",
  "docs": "https://ghaym.me/docs/errors/too-many-requests"
}