Ang Retry-After header ay isang HTTP response header na nagsasabi sa client kung gaano katagal dapat maghintay bago gumawa ng follow-up request. Maaaring isama ito ng server sa 429 Too Many Requests response, ang status code para sa rate limiting. Para sa isang scraper, ang paggalang sa halagang ito ay nangangahulugang paghinto sa loob ng itinakdang oras ng server, sa halip na hulaan at mag-risk ng mas maraming blocked requests.
Ang header ay opsyonal, kaya ang isang 429 response ay maaaring dumating nang wala ito. Ang RFC 6585 ay hindi rin nagtatakda kung paano kinikilala ng server ang user o binibilang ang mga request. Ang limitasyon ay maaaring nakatali sa login credentials o cookie, hindi lamang sa IP address.
Mga Format ng Retry-After Value
- Delay sa segundo: Isang non-negative whole number, tulad ng
Retry-After: 120. - HTTP date: Isang petsa kung kailan dapat muling subukan, tulad ng
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT. - Saan ito lumalabas: Sa 429 responses, sa 503 Service Unavailable upang ipakita kung gaano katagal dapat tumagal ang outage, at sa mga redirects tulad ng 301 upang itakda ang minimum na paghihintay.
Iba Pang Rate Limit Headers
- Vendor headers: Ang ilang APIs ay nagdadagdag ng kanilang sariling fields. Halimbawa, ang GitHub's REST API ay nagpapadala ng
x-ratelimit-limit,x-ratelimit-remaining,x-ratelimit-usedatx-ratelimit-reset. - Proposed standard: Isang IETF Internet-Draft ang nagtatakda ng
RateLimitatRateLimit-Policyfields upang maipahayag ng mga server ang quota policies at natitirang quota. Ito ay draft pa lamang, hindi pa isang published RFC. - Retry logic: Pinapayuhan ng GitHub na maghintay ng bilang ng segundo sa
retry-afterkapag naroroon, at pataasin ang paghihintay nang exponentially kung patuloy na nabibigo ang mga request.
Sino ang Gumagalang sa Retry-After
- Nag-iiba ang suporta: Itinuro ng MDN na ang suporta ng client at server para sa Retry-After ay hindi pa rin pare-pareho.
- Search crawlers: Ang ilang crawlers, tulad ng Googlebot, ay gumagalang dito. Sinabi ng Google na ang isang site ay maaaring magpadala ng Retry-After kasama ng 503 o 429 response upang sabihin sa crawler nito kung kailan dapat muling subukan.
- Panatilihing maikli: Pinapayuhan ng Google na huwag magbigay ng 500, 503 o 429 upang pabagalin ang crawling ng higit sa 1-2 araw. Kung makikita ng Googlebot ang mga code na ito sa parehong URL sa loob ng ilang araw, maaari nitong tanggalin ang URL na iyon mula sa index nito.