Header Retry-After adalah header respons HTTP yang memberitahu klien berapa lama untuk menunggu sebelum membuat permintaan susulan. Pelayan boleh menyertakannya dalam respons 429 Too Many Requests, kod status untuk had kadar. Bagi pengikis, menghormati nilai ini bermakna menghentikan seketika selama mana yang diminta oleh pelayan, bukannya meneka dan berisiko lebih banyak permintaan disekat.
Header ini adalah pilihan, jadi respons 429 mungkin tiba tanpa ia. RFC 6585 juga tidak mentakrifkan bagaimana pelayan mengenal pasti pengguna atau mengira permintaan. Had mungkin dikaitkan dengan kelayakan log masuk atau kuki, bukan hanya kepada alamat IP.
Format Nilai Retry-After
- Penangguhan dalam saat: Nombor bulat bukan negatif, seperti
Retry-After: 120. - Tarikh HTTP: Tarikh selepas yang mana untuk mencuba semula, seperti
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT. - Di mana ia muncul: Dengan respons 429, dengan 503 Service Unavailable untuk menunjukkan berapa lama gangguan harus bertahan, dan dengan pengalihan seperti 301 untuk menetapkan waktu minimum menunggu.
Header Had Kadar Lain
- Header vendor: Beberapa API menambah bidang mereka sendiri. API REST GitHub, sebagai contoh, menghantar
x-ratelimit-limit,x-ratelimit-remaining,x-ratelimit-useddanx-ratelimit-reset. - Standard yang dicadangkan: Draf Internet IETF mentakrifkan bidang
RateLimitdanRateLimit-Policysupaya pelayan boleh mengiklankan dasar kuota dan kuota yang tinggal. Ia masih draf, bukan RFC yang diterbitkan. - Logik percubaan semula: GitHub menasihatkan untuk menunggu bilangan saat dalam
retry-afterapabila ada, dan meningkatkan waktu menunggu secara eksponen jika permintaan terus gagal.
Siapa yang Menghormati Retry-After
- Sokongan berbeza-beza: MDN mencatatkan bahawa sokongan klien dan pelayan untuk Retry-After masih tidak konsisten.
- Pengikis carian: Beberapa pengikis, seperti Googlebot, menghormatinya. Google mengatakan bahawa laman web boleh menghantar Retry-After dengan respons 503 atau 429 untuk memberitahu pengikisnya bila untuk mencuba semula.
- Jaga ringkas: Google menasihatkan agar tidak memberikan 500, 503 atau 429 untuk memperlahankan pengikisan lebih dari 1-2 hari. Jika Googlebot melihat kod ini pada URL yang sama selama beberapa hari, ia mungkin mengeluarkan URL itu dari indeksnya.