หัวข้อ 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 เพื่อกำหนดเวลารอขั้นต่ำ
หัวข้อการจำกัดอัตราอื่น ๆ
- หัวข้อของผู้ขาย: API บางตัวเพิ่มฟิลด์ของตนเอง API REST ของ GitHub ตัวอย่างเช่น ส่ง
x-ratelimit-limit,x-ratelimit-remaining,x-ratelimit-usedและx-ratelimit-reset. - มาตรฐานที่เสนอ: ร่าง Internet-Draft ของ 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 เดียวกันหลายวัน อาจลบ URL นั้นออกจากดัชนีของตน