Referensi Kode Status HTTP

Referensi Kode Status HTTP adalah indeks lengkap yang dapat dicari dari setiap kode status yang ditentukan dalam spesifikasi HTTP — mulai dari 100 Continue hingga 511 Network Authentication Required. Setiap entri menampilkan nama kanonis, RFC yang mendefinisikannya, apa *arti* sebenarnya dari kode tersebut, kapan harus mengirimkannya, kapan *tidak* boleh mengirimkannya, dan jebakan umum yang sering terjadi pada codebase nyata. Filter langsung dan chip kategori memungkinkan Anda berpindah dari satu kelas ke kelas lainnya dalam satu klik.

Berbeda dengan cheatsheet biasa, alat ini memberikan mikro-halaman tersendiri untuk setiap kode dengan tiga panel berkode warna (harus dilakukan / tidak boleh dilakukan / jebakan) dan handler yang siap ditempel untuk Express.js, Django, FastAPI, dan Go net/http. Diagram alur beranimasi menunjukkan perjalanan permintaan dari klien ke server dan status terpilih yang mengalir kembali — berguna bagi pendatang baru yang sedang mempelajari apa yang sebenarnya diwakili oleh kode status di jaringan.

Mengapa referensi kode status itu penting

Cara menggunakan Referensi Kode Status HTTP

1. Pencarian cepat. Ketik kode (404) atau fragmen nama (teapot, gateway) ke dalam kotak pencarian di bagian atas dan kirim. Entri yang cocok akan terbuka dengan panel detail lengkap.
2. Telusuri berdasarkan kelas. Klik salah satu dari 5 chip (1xx, 2xx, 3xx, 4xx, 5xx) untuk memfilter kisi ke kelas tersebut. Klik Semua untuk mereset.
3. Filter langsung. Kotak filter tepat di atas kisi mempersempit kartu saat Anda mengetik — berguna ketika Anda hanya mengingat setengah nama seperti too many atau precondition.
4. Periksa kode. Klik kartu apa saja untuk membuka panel detailnya. Anda akan melihat arti, kapan harus digunakan, kapan tidak boleh digunakan, jebakan umum, dan blok cuplikan 4 frameworkBlock.
5. Salin cuplikan. Gunakan pengalih tab dan tombol kecil Salin untuk mengambil handler yang siap ditempel.
6. Bandingkan kode terdekat. Panel detail diakhiri dengan kartu sejenis dari kelas yang sama (1xx / 2xx / 3xx / 4xx / 5xx) untuk perbandingan langsung yang cepat.

Sekilas tentang lima kelas status HTTP

Pasangan yang sering membingungkan

• 401 vs 403. 401 berarti tidak terautentikasi — permintaan tidak memiliki kredensial yang valid. 403 berarti terautentikasi tetapi tidak diizinkan — kredensialnya baik tetapi pengguna tidak memiliki izin.
• 404 vs 410. 404 berarti tidak diketahui: mungkin ada di suatu tempat, mungkin salah ketik. 410 berarti sengaja dihapus: mesin pencari harus menghapusnya dari indeks.
• 301 vs 302 vs 307 vs 308. 301 / 308 bersifat permanen (308 sangat mempertahankan metode & bodi), 302 / 307 bersifat sementara (307 sangat mempertahankan metode & bodi). Gunakan 307 / 308 untuk pengalihan POST / PUT / PATCH.
• 400 vs 422. 400 berarti bodi permintaan cacat (JSON buruk, bidang hilang). 422 berarti bodi berhasil diurai dengan bersih tetapi nilai-nilainya gagal dalam aturan bisnis (format email tidak valid, kuantitas di luar jangkauan).
• 502 vs 503 vs 504. 502 berarti upstream mengirimkan sampah. 503 berarti server kelebihan beban atau dalam pemeliharaan. 504 berarti upstream tidak merespons tepat waktu.
• 409 vs 412. 409 adalah konflik dengan keadaan sumber daya saat ini. 412 secara khusus berarti header prasyarat (If-Match, If-Unmodified-Since) dievaluasi sebagai salah.

Header yang berpasangan dengan kode status tertentu

• 201 Created — harus menyertakan Location yang mengarah ke sumber daya baru.
• 301 / 302 / 307 / 308 — harus menyertakan Location dengan URL target.
• 304 Not Modified — harus menggandakan header yang seharusnya muncul pada 200 (ETag, Cache-Control, Vary).
• 401 Unauthorized — harus menyertakan WWW-Authenticate yang mencantumkan skema yang diterima (Basic, Bearer).
• 405 Method Not Allowed — harus menyertakan Allow yang mencantumkan metode yang *memang* diizinkan.
• 413 / 429 / 503 — sering kali menyertakan Retry-After (detik atau tanggal HTTP) agar klien mundur dengan benar.
• 416 Range Not Satisfiable — harus menyertakan Content-Range: bytes */<length>.

Kode status yang hampir selalu bisa Anda abaikan

Segelintir kode secara teknis valid tetapi sangat jarang digunakan dalam API modern: 305 Use Proxy (usang), 306 (dipesan, tidak digunakan), 305, 506 Variant Also Negotiates, 510 Not Extended, dan 508 Loop Detected. Sebagian besar disimpan dalam registri untuk alasan historis. Jika library atau middleware Anda mengeluarkan salah satu dari kode tersebut, anggap itu sebagai laporan bug terhadap library tersebut — bukan petunjuk untuk menanganinya secara khusus.

FAQ

Apakah alat ini menyertakan kode dari RFC selain 9110?

Ya. Ini mencakup RFC 9110 (semantik HTTP), RFC 6585 (4xx / 5xx tambahan), RFC 4918 (WebDAV), RFC 5842 (pengikatan WebDAV), RFC 7725 (451), RFC 8297 (103 Early Hints), RFC 8470 (425 Too Early), dan RFC 2324 yang terkenal jenaka (418 Teapot).

Apakah kode-kode ini valid di HTTP/2 dan HTTP/3?

Ya. Semantik kode status ditentukan dalam RFC 9110, yang merupakan dokumen semantik HTTP yang tidak bergantung pada versi. HTTP/2 (RFC 9113) dan HTTP/3 (RFC 9114) hanya mengubah pembingkaian (framing) dan transportasi.

Bisakah saya menautkan langsung ke kode tertentu?

Kirim formulir dengan satu kode (misalnya 404) dan panel detail akan dimuat di bawah formulir. URL tersebut menunjukkan pencarian Anda dan aman untuk dibagikan — membukanya akan memuat hasil yang sama.

Mengapa framework saya tidak mengizinkan saya mengembalikan 418?

Versi lama dari beberapa library HTTP menolak untuk mengeluarkan kode yang tidak ada dalam registri internal mereka. Solusinya adalah dengan memperbarui library atau, jika memungkinkan, menulis baris status secara manual.

Haruskah API mengembalikan 200 dengan bodi kesalahan?

Tidak. Pemantauan, percobaan ulang, dan perantara semuanya mengasumsikan 2xx berarti sukses. Jika Anda harus mengembalikan struktur kesalahan, kembalikan 4xx atau 5xx yang sesuai dan tempatkan detail terstruktur di dalam bodi. Format Problem Details untuk HTTP API (RFC 9457) adalah templat yang bagus.

Apakah ada registri otoritatif untuk kode status HTTP?

Ya. IANA memelihara registri di iana.org/assignments/http-status-codes. Alat ini tetap sinkron dengan registri tersebut ditambah RFC yang paling sering dikutip.