رأس Retry-After هو رأس استجابة HTTP يخبر العميل بمدة الانتظار قبل تقديم طلب متابعة. يمكن للخادم تضمينه في استجابة 429 Too Many Requests، وهو رمز الحالة لحدود المعدل. بالنسبة للبرامج الآلية، فإن احترام هذه القيمة يعني التوقف لمدة طويلة كما طلب الخادم، بدلاً من التخمين والمخاطرة بحظر المزيد من الطلبات.

الرأس اختياري، لذا قد تصل استجابة 429 بدونه. كما أن RFC 6585 لا يحدد كيفية تحديد الخادم للمستخدم أو عد الطلبات. قد يكون الحد مرتبطًا ببيانات اعتماد تسجيل الدخول أو ملف تعريف الارتباط، وليس فقط بعنوان IP.

تنسيقات قيمة Retry-After

  • تأخير بالثواني: رقم صحيح غير سالب، مثل Retry-After: 120.
  • تاريخ HTTP: تاريخ بعده يمكن إعادة المحاولة، مثل Retry-After: Wed, 21 Oct 2015 07:28:00 GMT.
  • أين يظهر: مع استجابات 429، مع 503 Service Unavailable لإظهار مدة الانقطاع، ومع إعادة التوجيه مثل 301 لتحديد الحد الأدنى من الانتظار.

رؤوس حدود المعدل الأخرى

  • رؤوس البائع: تضيف بعض واجهات برمجة التطبيقات حقولها الخاصة. على سبيل المثال، ترسل واجهة برمجة التطبيقات REST الخاصة بـ GitHub x-ratelimit-limit، x-ratelimit-remaining، x-ratelimit-used و x-ratelimit-reset.
  • المعيار المقترح: يحدد مشروع إنترنت IETF حقول RateLimit و RateLimit-Policy حتى تتمكن الخوادم من الإعلان عن سياسات الحصة والحصة المتبقية. لا يزال مسودة، وليس RFC منشور.
  • منطق إعادة المحاولة: تنصح GitHub بالانتظار لعدد الثواني في retry-after عند وجوده، وزيادة فترة الانتظار بشكل أسي إذا استمرت الطلبات في الفشل.

من يحترم Retry-After

  • الدعم متنوع: تشير MDN إلى أن دعم العميل والخادم لرأس Retry-After لا يزال غير متسق.
  • زواحف البحث: بعض الزواحف، مثل Googlebot، تحترم ذلك. تقول Google إن الموقع يمكنه إرسال Retry-After مع استجابة 503 أو 429 لإخبار زاحفها متى يجب إعادة المحاولة.
  • اجعلها قصيرة: تنصح Google بعدم تقديم 500 أو 503 أو 429 لإبطاء الزحف لأكثر من 1-2 يوم. إذا رأت Googlebot هذه الرموز على نفس عنوان URL لعدة أيام، فقد تسقط ذلك العنوان من فهرسها.

المصطلحات ذات الصلة