หัวข้อ 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 นั้นออกจากดัชนีของตน

ข้อกำหนดที่เกี่ยวข้อง