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"
}