Retry-After

Penggunaan

Header Retry-After muncul pada response ketika server perlu meminta klien menunda sebelum mencoba lagi. Header ini umumnya dipasangkan dengan tiga status code:

Header ini menerima dua format: jeda dalam detik (delta-seconds) atau HTTP-date absolut. Saat menggunakan detik, nilainya berupa bilangan bulat non-negatif yang menyatakan jumlah detik yang harus ditunggu. Saat menggunakan HTTP-date, nilainya mengikuti format IMF-fixdate.

Klien dan crawler yang berperilaku baik mematuhi header ini agar tidak membanjiri server yang sedang pulih.

Catatan

Crawler mesin pencari memperlakukan Retry-After pada response 503 sebagai sinyal untuk mengunjungi kembali URL tersebut nanti, alih-alih menghapus halaman itu dari indeks. Googlebot maupun Bingbot sama-sama menghormati header ini untuk menjadwalkan kunjungan ulang. Selama pemeliharaan terencana, mengembalikan 503 Service Unavailable disertai Retry-After menjaga kemampuan halaman untuk tetap terindeks. Tanpa header tersebut, downtime yang berkepanjangan berisiko menyebabkan deindexing.

Delta-seconds

Bilangan bulat non-negatif yang menentukan jumlah detik yang harus ditunggu klien sebelum mengulangi permintaan.

Retry-After: 120

HTTP-date

Tanggal dan waktu absolut dalam format IMF-fixdate, setelahnya klien bebas mencoba lagi. Tanggal tersebut menggunakan GMT dan mengikuti format Day, DD Mon YYYY HH:MM:SS GMT.

Retry-After: Sat, 31 Oct 2026 18:00:00 GMT

Contoh

Sebuah server yang merespons dengan 503 selama jendela pemeliharaan memberi tahu klien untuk menunggu 3600 detik (satu jam) sebelum mencoba lagi.

HTTP/1.1 503 Service Unavailable
Retry-After: 3600

Sebuah pembatas laju API yang merespons dengan 429 menyediakan tanggal absolut saat batas laju direset. Klien menghentikan sementara permintaannya hingga waktu yang ditentukan.

HTTP/1.1 429 Too Many Requests
Retry-After: Sat, 31 Oct 2026 12:30:00 GMT

Sebuah pengalihan terjadwal dengan 301 menyertakan jeda untuk mencegah badai percobaan ulang seketika dari banyak klien.

HTTP/1.1 301 Moved Permanently
Location: https://new.example.re/resource
Retry-After: 60

Catatan

Pembatas laju API kerap memasangkan Retry-After dengan header RateLimit-Limit. Header RateLimit-Remaining menunjukkan berapa banyak permintaan yang tersisa pada jendela saat ini, sedangkan Retry-After memberi tahu klien kapan tepatnya dapat melanjutkan setelah response 429. API yang dirancang dengan baik menyertakan keduanya agar klien mundur secara halus alih-alih terus menggempur endpoint yang dibatasi lajunya.