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 سروس دستیاب نہیں میں یہ دکھانے کے لیے کہ آؤٹج کتنی دیر تک جاری رہے گا، اور 301 جیسے ری ڈائریکٹس کے ساتھ کم از کم انتظار طے کرنے کے لیے۔
دیگر ریٹ لمیٹ ہیڈرز
- وینڈر ہیڈرز: کچھ APIs اپنے ہی فیلڈز شامل کرتے ہیں۔ GitHub کا REST API، مثال کے طور پر،
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 کہتا ہے کہ ایک سائٹ 503 یا 429 جواب کے ساتھ Retry-After بھیج سکتی ہے تاکہ اپنے کرالر کو بتا سکے کہ کب دوبارہ کوشش کرنی ہے۔
- اسے مختصر رکھیں: Google مشورہ دیتا ہے کہ 500، 503 یا 429 کو 1-2 دن سے زیادہ سست کرالنگ کے لیے پیش نہ کریں۔ اگر Googlebot ایک ہی URL پر کئی دنوں تک یہ کوڈز دیکھتا ہے، تو یہ اس URL کو اپنی فہرست سے خارج کر سکتا ہے۔