Apa arti kode status HTTP

Setiap kali browser Anda memuat halaman atau aplikasi memanggil API, server membalas dengan kode status tiga digit. Sebagian besar waktu Anda tak pernah melihatnya, tetapi ketika sesuatu rusak — 404, 500 — angka itu adalah petunjuk pertama. Panduan ini mengajari Anda membaca kode status sekilas.

Baca digit pertama

Triknya, digit pertama memberi tahu Anda kategorinya, jadi Anda bisa memahami maksud kode yang belum pernah dilihat:

• 1xx — Informational: diterima, masih diproses (jarang dalam pemakaian sehari-hari).
• 2xx — Success: berhasil.
• 3xx — Redirection: sumber daya ada di tempat lain.
• 4xx — Client error: permintaan salah (pihak Anda).
• 5xx — Server error: permintaan baik-baik saja, server yang gagal.

Pemisahan 4xx lawan 5xx itu adalah pembeda paling berguna saat men-debug: 4xx berarti perbaiki permintaan; 5xx berarti server yang salah.

Kode yang benar-benar Anda temui

Sukses dan pengalihan

• 200 OK — respons standar “berhasil”.
• 201 Created — sumber daya baru dibuat (setelah POST).
• 301 Moved Permanently — URL ini pindah permanen; perbarui tautan Anda. Penting untuk SEO.
• 302 Found — pengalihan sementara; teruslah pakai URL asli.
• 304 Not Modified — salinan cache Anda masih valid, jadi tak ada yang dikirim ulang.

Galat klien (4xx)

• 400 Bad Request — permintaan salah bentuk.
• 401 Unauthorized — Anda perlu autentikasi (masuk).
• 403 Forbidden — Anda terautentikasi tetapi tak diizinkan.
• 404 Not Found — sumber daya tak ada.
• 429 Too Many Requests — Anda dibatasi laju; pelankan.

Galat server (5xx)

• 500 Internal Server Error — kegagalan sisi server yang umum.
• 502 Bad Gateway — server hulu mengembalikan respons buruk.
• 503 Service Unavailable — server kelebihan beban atau mati untuk pemeliharaan.
• 504 Gateway Timeout — server hulu tak merespons tepat waktu.

401 vs. 403: kekeliruan yang umum

Kedua ini terasa mirip tetapi beda dalam satu kata. 401 Unauthorized sebenarnya berarti “tak terautentikasi” — server tak tahu siapa Anda, jadi masuklah. 403 Forbidden berarti server tahu siapa Anda dan tetap saja Anda tak diizinkan. Yang satu soal identitas, yang lain soal izin.

Daftar lengkap

Untuk tiap kode terdaftar beserta artinya — dapat dicari dan dikelompokkan per kelas — lihat referensi lengkap kode status HTTP kami. Jika Anda men-debug respons API, panduan kami tentang JWT dan pengodean URL membahas dua hal lain yang akan terus Anda jumpai.