Artinya
Server untuk sementara tidak bisa menangani permintaan karena kelebihan beban atau pemeliharaan. Retry-After bisa memberi tahu kapan mencoba lagi.
Penyebab umum
- Pemeliharaan terjadwal
- Server kelebihan beban atau kehabisan worker
- Autoscaling belum mengejar, atau dependensi mengalami gangguan
Cara memperbaiki
Sebagai klien atau pengunjung
Coba lagi nanti sesuai Retry-After.
Sebagai pengelola situs atau API
Kirim Retry-After saat pemeliharaan, tambah kapasitas, dan kurangi beban dengan mulus. Mesin pencari menganggap 503 singkat sebagai sementara.
Contoh respons
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}Spesifikasi
FAQ
› Apakah 503 cocok untuk halaman pemeliharaan?
Ya. Kembalikan 503 dengan Retry-After; mesin pencari akan tetap mengindeks halaman alih-alih menganggapnya hilang.
› 503 atau 500?
503 menyatakan gangguan bersifat sementara dan diharapkan pulih; 500 adalah kegagalan tak terduga.