خطأ HTTP 429 Too Many Requests
كود الحالة 429 · الفئة 4xx
الرسالة الرسمية (كما تظهر على الشاشة): Too Many Requests
يُبحث عنه أيضًا باسم: error 429, HTTP 429, 429 too many requests, rate limited
ماذا يعني
يعني 429 Too Many Requests أنك أو عنوان IP الخاص بك أو مفتاح API أرسلتم طلبات أكثر مما تسمح به الخدمة خلال فترة زمنية. إنه تحديد للمعدل (rate limiting): تعمل الطلبات من جديد بعد الانتظار. يواجهه الزوار في المواقع المزدحمة وعند مشاركة IP عبر VPN، ويواجهه المطورون في واجهات API.
ينطبق على: جميع المتصفحات, REST APIs, Cloudflare, nginx
كيفية إصلاح خطأ HTTP 429 Too Many Requests
- انتظر ثم أعد المحاولة لاحقاً؛ وافحص ترويسة الاستجابة 'Retry-After' لمعرفة عدد الثواني الواجب انتظارها
- توقف عن التحديث السريع المتكرر وأغلق علامات التبويب أو السكربتات الزائدة التي تصل إلى الموقع نفسه
- افصل VPN أو الوكيل (proxy)، لأن عناوين IP المشتركة تستنفد الحدود بسرعة
- عملاء API: أضف تراجعاً أسّياً (exponential backoff) مع jitter والتزم بـ Retry-After بدلاً من إعادة المحاولة في حلقة سريعة
- عملاء API: خزّن الاستجابات مؤقتاً وجمّع الطلبات لاستخدام عدد أقل من الاستدعاءات؛ وافحص لوحة الحصة (quota) في خطتك
- إذا كنت مالك الموقع: راجع قواعد تحديد المعدل في WAF أو CDN أو التطبيق (nginx 'limit_req') حتى لا يُحظر المستخدمون العاديون والروبوتات الجيدة
- إذا كنت مالك الموقع: أرجع Retry-After مع 429 ليبطئ العملاء الملتزمون تلقائياً
سبب حدوثه
يعرّف RFC 6585 الرمز 429 لتحديد المعدل. تُحتسب الحدود لكل IP أو مستخدم أو مفتاح API أو نقطة نهاية، وأي دفعة طلبات تتجاوزها، بما فيها من عناوين IP المشتركة، تُرفض حتى تتجدد النافذة الزمنية.
الأسئلة الشائعة
هل خطأ 429 ذنبي أنا؟
يحدث بسبب حجم الطلبات الصادرة منك أو من عنوان IP الخاص بك. وإذا كنت تشارك عنوان IP (VPN أو مكتب أو شركة اتصالات)، فقد تدفعك حركة مرور الآخرين إلى تجاوز الحد.
كم يستمر خطأ 429؟
يعتمد على الخدمة. افحص ترويسة Retry-After؛ وتتجدد حدود كثيرة خلال دقيقة إلى ساعة.
أخطاء ذات صلة
المصدر: IANA HTTP Status Code Registry · حلول كتبها المحررون وراجعوها (راجع السياسة التحريرية)
آخر تحديث: