Langkau ke kandungan utama

Rujukan Kod Status HTTP percuma

Rujukan yang boleh dicari untuk semua kod status HTTP — maksud setiap satu, bila digunakan, dan punca biasa. Dari 100 hingga 511.

Berfungsi luar talian selepas dimuatkan

61 kod status

100

Teruskan

Pelayan telah menerima pengepala permintaan dan klien boleh meneruskan dengan badan.

Digunakan untuk permintaan dengan Expect: 100-continue. Pelayan mengakui bahawa ia bersedia menerima badan sebelum klien menghantarnya. Jarang dilihat dalam aplikasi web moden.

RFC 9110 ↗
101

Menukar Protokol

Pelayan sedang menukar protokol seperti yang diminta oleh klien.

Paling biasa digunakan untuk peningkatan WebSocket — klien meminta Upgrade: websocket dan pelayan merespons 101 untuk beralih.

RFC 9110 ↗
102

Memproses

Pelayan telah menerima permintaan dan sedang memprosesnya, tetapi respons belum tersedia.

Respons sementara WebDAV yang dihantar untuk mencegah masa henti klien semasa operasi yang panjang. Tidak digalakkan — pelayan moden tidak seharusnya menghantarnya.

RFC 2518 ↗
103

Petunjuk Awal

Pengepala awal yang dihantar sebelum respons akhir.

Membolehkan pelayan menghantar pengepala Pautan (preload/preconnect) semasa respons akhir masih sedang disediakan, supaya penyemak imbas boleh mula mengambil aset penting dengan lebih cepat.

RFC 8297 ↗
200

OK

Permintaan berjaya.

Respons kejayaan piawai. Maksudnya bergantung pada kaedah HTTP: GET → sumber dikembalikan, POST/PUT → tindakan selesai.

RFC 9110 ↗
201

Dibuat

Sumber baru telah berjaya dibuat.

Biasa selepas POST. Respons harus memasukkan pengepala Lokasi yang menunjuk ke URL sumber baru.

RFC 9110 ↗
202

Diterima

Permintaan diterima untuk pemprosesan, tetapi pemprosesan belum selesai.

Untuk operasi tidak segerak — pelayan sedang berbaris dengan kerja. Klien harus mengundian titik akhir status atau memeriksa semula kemudian.

RFC 9110 ↗
203

Maklumat Bukan-Pihak Berkuasa

Respons telah diubah oleh proksi yang mengubah.

Permintaan berjaya, tetapi perantara (seperti proksi caching atau mengubah) mengubah muatan daripada pelayan asal — contohnya, memampatkan semula imej. Jarang dalam praktik.

RFC 9110 ↗
204

Tiada Kandungan

Permintaan berjaya tetapi tiada badan respons.

Sering digunakan untuk operasi DELETE atau kemas kini PUT yang tidak perlu mengembalikan badan. Klien tidak seharusnya menavigasi keluar dari halaman semasa.

RFC 9110 ↗
205

Set Semula Kandungan

Permintaan berjaya; klien harus menetapkan semula pandangan dokumen.

Seperti 204, tiada badan dikembalikan — tetapi klien juga diberitahu untuk menetapkan semula borang atau pandangan yang menghasilkan permintaan (cth. kosongkan medan borang untuk kemasukan seterusnya).

RFC 9110 ↗
206

Kandungan Separa

Pelayan menyampaikan hanya sebahagian daripada sumber.

Respons kepada permintaan Julat. Digunakan oleh pemain video dan pengurus muat turun untuk menyambung semula muat turun terputus atau aliran fail besar.

RFC 9110 ↗
207

Status Berbilang

Badan respons mengandungi berbilang kod status untuk berbilang operasi.

WebDAV: badan XML melaporkan hasil beberapa sub-operasi secara bebas — cth. pergerakan batch di mana beberapa item berjaya dan yang lain gagal.

RFC 4918 ↗
208

Telah Dilaporkan

Ahli koleksi telah disenaraikan sebelumnya dalam respons.

WebDAV: digunakan dalam respons 207 Multi-Status untuk mengelak daripada menyenaraikan ahli koleksi yang sama berulang kali apabila ikatan mencipta gelung.

RFC 5842 ↗
226

IM Digunakan

Respons adalah hasil manipulasi contoh yang digunakan pada sumber.

Pengekodan delta: pelayan mengembalikan perbezaan terhadap versi terdahulu dan bukannya sumber penuh, menjimatkan jalur lebar. Sangat jarang dilaksanakan.

RFC 3229 ↗
300

Pilihan Berbilang

Beberapa perwakilan sumber tersedia.

Pelayan menawarkan berbilang pilihan (cth. format atau bahasa berbeza) dan klien harus memilih satu. Jarang digunakan, kerana rundingan kandungan automatik biasanya menangani ini.

RFC 9110 ↗
301

Dipindahkan Kekal

Sumber telah pindah secara kekal ke URL baru.

Gunakan untuk perubahan URL kekal — enjin carian akan mengemaskini indeks mereka. Kuasa SEO dipindahkan ke URL baru.

RFC 9110 ↗
302

Ditemui (Pengalihan Sementara)

Sumber berada sementara di URL berbeza.

Menunjukkan bahawa pengalihan tidak kekal. Caching kurang agresif daripada 301. Gunakan untuk perkara seperti 'login diperlukan, mengalihkan ke /login'.

RFC 9110 ↗
303

Lihat Lain

Alihkan ke URL berbeza menggunakan GET.

Digunakan selepas penyerahan POST — respons mengatakan 'POST anda berjaya, lihat URL GET ini untuk hasilnya'. Penyemak imbas sentiasa GET URL baru.

RFC 9110 ↗
304

Tidak Diubah

Versi bertambah masih sah; gunakannya.

Respons kepada permintaan bersyarat (dengan If-None-Match atau If-Modified-Since pengepala). Menjimatkan jalur lebar — tiada badan dikembalikan.

RFC 9110 ↗
307

Pengalihan Sementara

Seperti 302 tetapi mengekalkan kaedah HTTP asal.

Jika asal adalah POST, pengalihan juga menggunakan POST. Alternatif moden untuk 302 apabila pemuliharaan kaedah penting.

RFC 9110 ↗
308

Pengalihan Kekal

Seperti 301 tetapi mengekalkan kaedah HTTP asal.

Pengganti moden untuk 301 apabila anda mahu permintaan POST kekal POST selepas pengalihan.

RFC 9110 ↗
400

Permintaan Salah

Pelayan tidak dapat memahami permintaan kerana sintaks yang salah bentuk.

Penyebab biasa: JSON yang salah bentuk dalam badan, parameter pertanyaan tidak sah, atau medan yang diperlukan hilang. Periksa badan permintaan dan pengepala.

RFC 9110 ↗
401

Tidak Diberi Kuasa

Pengesahan diperlukan dan belum disediakan.

Klien mesti memasukkan bukti kelayakan pengesahan (pengepala Kebenaran, kuki, token). 'Tidak Diberi Kuasa' adalah nama yang salah — ini benar-benar bermaksud 'tidak disahkan'.

RFC 9110 ↗
402

Pembayaran Diperlukan

Terpelihara untuk kegunaan masa depan — kadang-kadang digunakan untuk peringkat API berbayar.

Pada asalnya bertujuan untuk pembayaran digital. Penggunaan moden: API kadang-kadang mengembalikan 402 apabila pengguna melebihi kuota berbayar mereka.

RFC 9110 ↗
403

Dilarang

Klien disahkan tetapi tidak mempunyai kebenaran.

Berbeza daripada 401 — pengguna ADALAH log masuk, tetapi akaun mereka tidak mempunyai kebenaran untuk sumber ini. Periksa logik peranan/kebenaran.

RFC 9110 ↗
404

Tidak Ditemui

Sumber yang diminta tidak wujud.

Sama ada URL salah, sumber telah dipadamkan, atau tidak pernah wujud. Pelayan kadang-kadang mengembalikan 404 untuk menyembunyikan bahawa 403 akan lebih tepat.

RFC 9110 ↗
405

Kaedah Tidak Dibenarkan

Kaedah HTTP yang digunakan tidak dibenarkan untuk sumber ini.

Sebagai contoh, permintaan GET ke titik akhir yang hanya menerima POST. Respons harus memasukkan pengepala Benarkan yang menyenaraikan kaedah yang sah.

RFC 9110 ↗
406

Tidak Boleh Diterima

Tiada perwakilan yang sepadanan dengan pengepala Terima klien.

Klien meminta jenis kandungan, bahasa, atau pengekodan (melalui Accept, Accept-Language, Accept-Encoding) yang tidak dapat disanggupi pelayan. Banyak pelayan melangkau rundingan ketat dan mengembalikan lalai sebagai gantinya.

RFC 9110 ↗
407

Kebenaran Proksi Diperlukan

Klien mesti mengesahkan diri dengan proksi dahulu.

Seperti 401, tetapi dikeluarkan oleh proksi: klien mesti menghantar bukti kelayakan Kebenaran-Proksi. Dilihat di rangkaian korporat dengan proksi yang disahkan.

RFC 9110 ↗
408

Permintaan Tamat Masa

Pelayan tamat masa menunggu permintaan.

Klien mengambil masa terlalu lama untuk menghantar badan permintaan atau mengekalkan sambungan terbiar. Cuba permintaan itu lagi.

RFC 9110 ↗
409

Konflik

Permintaan bercanggah dengan keadaan semasa sumber.

Biasanya dikembalikan untuk konflik pengeditan serentak atau penciptaan sumber pendua (cth., mencipta pengguna dengan e-mel yang sudah wujud).

RFC 9110 ↗
410

Hilang

Sumber telah dipadamkan dan tidak akan kembali.

Lebih kuat daripada 404 — pelayan secara tegas tahu sumber PERNAH wujud tetapi telah dikeluarkan secara kekal. Enjin carian akan menyahindeks.

RFC 9110 ↗
411

Panjang Diperlukan

Pelayan memerlukan pengepala Content-Length.

Permintaan ditolak kerana ia kekurangan pengepala Content-Length dan pelayan menolak badan dengan saiz yang tidak diketahui. Tambahkan pengepala dan cuba lagi.

RFC 9110 ↗
412

Syarat Tidak Dipenuhi

Syarat dalam pengepala permintaan tidak dipenuhi.

Dikembalikan apabila pengepala bersyarat seperti If-Match atau If-Unmodified-Since gagal — biasanya penguncian optimistik: orang lain telah mengubah sumber sejak versi anda. Ambil semula dan cuba lagi.

RFC 9110 ↗
413

Muatan Terlalu Besar

Badan permintaan melebihi had saiz pelayan.

Umum apabila memuat naik fail besar. Konfigurasi pelayan (nginx, apache) menetapkan saiz badan maksimum. Semak konfigurasi pelayan.

RFC 9110 ↗
414

URI Terlalu Panjang

URL permintaan melebihi had panjang pelayan.

Biasanya disebabkan oleh rentetan pertanyaan yang sangat panjang (cth. mengekod data dalam GET). Tukar ke badan POST, atau naikkan had pelayan jika anda mengawalnya.

RFC 9110 ↗
415

Jenis Media Tidak Disokong

Pelayan tidak boleh mengendalikan Content-Type yang dihantar.

Sebagai contoh, menghantar application/xml ke pelayan yang hanya menerima application/json. Tetapkan pengepala Content-Type dengan betul.

RFC 9110 ↗
416

Julat Tidak Memuaskan

Julat bait yang diminta berada di luar saiz sumber.

Pengepala Range meminta bahagian yang fail tidak miliki — cth. meneruskan muat turun melepas akhir fail. Respons harus menyertakan Content-Range dengan saiz sebenar.

RFC 9110 ↗
417

Jangkaan Gagal

Pelayan tidak boleh memenuhi keperluan pengepala Expect.

Dihantar apabila pelayan tidak menyokong Expect: 100-continue. Sesetengah klien menghantar pengepala ini secara lalai pada POST besar; melumpuhkannya biasanya menyelesaikan ralat.

RFC 9110 ↗
418

Saya Teko

Pelayan menolak untuk membuat kopi kerana ia teko.

Lawakan Hari Bebal dari 1998 (RFC 2324). Sesetengah API sebenar menggunakannya untuk lawakan atau menandakan titik henti yang sudah lapuk. Bukan untuk penggunaan pengeluaran.

RFC 2324 ↗
421

Permintaan Tersalah Arah

Permintaan dihantar ke pelayan yang tidak dapat menghasilkan respons untuknya.

Umum dengan penggunaan semula sambungan HTTP/2: permintaan mencapai pelayan yang tidak dikonfigurasi untuk nama hos sasaran. Klien harus mencuba lagi pada sambungan baru.

RFC 9110 ↗
422

Kandungan Tidak Boleh Diproses

Permintaan bersintaks sah tetapi bermakna salah.

Sebagai contoh, JSON diuraikan dengan betul tetapi medan yang diperlukan hilang, atau nilai medan berada di luar julat. Umum dalam respons pengesahan API REST.

RFC 9110 ↗
423

Dikunci

Sumber dikunci.

WebDAV: sumber sumber atau sasaran dikunci oleh klien lain, jadi operasi tidak dapat diteruskan. Tunggu kunci dilepaskan atau putuskannya dengan token yang betul.

RFC 4918 ↗
424

Pergantungan Gagal

Permintaan gagal kerana permintaan bersandar sebelumnya gagal.

WebDAV: dalam rantai operasi bersandar, tindakan awal gagal, jadi yang ini tidak dilakukan. Lihat kegagalan awal untuk punca utama.

RFC 4918 ↗
425

Terlalu Awal

Pelayan menolak memproses permintaan yang mungkin dimainkan semula.

Berkaitan dengan data awal TLS 1.3 0-RTT: pelayan tidak akan mengambil risiko memproses permintaan yang mungkin dimainkan semula. Klien harus mencuba lagi selepas handshake selesai.

RFC 8470 ↗
426

Peningkatan Diperlukan

Klien mesti beralih ke protokol yang berbeza.

Pelayan menolak melayani permintaan melalui protokol semasa tetapi akan selepas peningkatan — respons merangkumi pengepala Upgrade yang menamakan protokol yang diperlukan.

RFC 9110 ↗
428

Syarat Diperlukan

Pelayan memerlukan permintaan untuk bersyarat.

Pelayan menuntut pengepala bersyarat (seperti If-Match) untuk mencegah konflik kehilangan-kemaskini. Ambil sumber, tangkap ETag-nya, dan hantar semula dengan If-Match.

RFC 6585 ↗
429

Terlalu Banyak Permintaan

Klien sedang dihadkan kadar.

Perlahan. Respons harus merangkumi pengepala Retry-After yang menunjukkan bila hendak cuba lagi. Umum dengan API yang mempunyai kuota permintaan.

RFC 6585 ↗
431

Medan Pengepala Permintaan Terlalu Besar

Pengepala terlalu besar untuk pelayan memproses.

Sama ada satu pengepala atau jumlah saiz pengepala melebihi had — paling kerap disebabkan oleh kuki bersaiz besar. Kosongkan kuki atau kurangkan apa yang aplikasi anda simpan dalamnya.

RFC 6585 ↗
451

Tidak Tersedia Atas Sebab Undang-undang

Akses ditolak kerana tuntutan undang-undang.

Sumber diblokir atas sebab undang-undang — penapisan, arahan mahkamah, atau peraturan wilayah. Nombor itu adalah rujukan kepada novel Fahrenheit 451.

RFC 7725 ↗
500

Ralat Pelayan Dalaman

Pelayan menghadapi keadaan yang tidak dijangka.

Tangkapan generik untuk ralat pihak pelayan. Periksa log pelayan untuk punca sebenar: pengecualian tidak tertangani, ralat pangkalan data, dll.

RFC 9110 ↗
501

Tidak Dilaksanakan

Pelayan tidak menyokong fungsi yang diminta.

Sebagai contoh, pelayan tidak mengenali kaedah HTTP. Jarang dalam praktik — lebih kerap anda akan melihat 405.

RFC 9110 ↗
502

Pintu Gerbang Buruk

Pelayan, bertindak sebagai pintu gerbang, mendapat respons buruk daripada pelayan hulu.

Umum dalam seni bina layanan mikro. Penyeimbang beban atau proksi terbalik anda mendapat respons yang salah bentuk daripada perkhidmatan belakang.

RFC 9110 ↗
503

Perkhidmatan Tidak Tersedia

Pelayan sementara tidak dapat mengendalikan permintaan.

Sama ada turun untuk penyelenggaraan atau kelebihan beban. Respons harus merangkumi pengepala Retry-After. Sering dikembalikan semasa penggunaan.

RFC 9110 ↗
504

Tamat Masa Pintu Gerbang

Pelayan pintu gerbang tamat masa menunggu respons hulu.

Perkhidmatan belakang tidak bertindak balas dengan cukup cepat. Periksa kesihatan perkhidmatan hulu dan konfigurasi tamat masa.

RFC 9110 ↗
505

Versi HTTP Tidak Disokong

Pelayan tidak menyokong versi HTTP yang digunakan dalam permintaan.

Versi HTTP utama permintaan tidak disokong oleh pelayan. Hampir tidak pernah dilihat dengan klien moden.

RFC 9110 ↗
506

Varian Juga Berunding

Pelayan mempunyai salkeliruan konfigurasi rundingan kandungan.

Rundingan kandungan telus berakhir dalam gelung: varian yang dipilih sendiri dikonfigurasi untuk berunding. Menunjukkan ralat konfigurasi pelayan.

RFC 2295 ↗
507

Penyimpanan Tidak Mencukupi

Pelayan kehabisan ruang cakera.

Asal khusus WebDAV tetapi kadangkala digunakan oleh pelayan umum. Bermaksud pelayan tidak boleh menyimpan permintaan kerana kekangan penyimpanan.

RFC 4918 ↗
508

Gelung Dikesan

Pelayan mengesan gelung tak terhingga semasa memproses permintaan.

WebDAV: memproses permintaan Depth: infinity memasuki gelung (cth. ikatan bulat). Operasi ditamatkan.

RFC 5842 ↗
510

Tidak Dilanjutkan

Sambungan lanjut kepada permintaan diperlukan.

Dari Rangka Kerja Sambungan HTTP yang sudah lapuk: pelayan memerlukan maklumat lanjut sebelum ia dapat memenuhi permintaan. Secara berkesan tidak digunakan di web moden.

RFC 2774 ↗
511

Pengesahan Rangkaian Diperlukan

Klien mesti mengesahkan untuk mendapatkan akses rangkaian.

Digunakan oleh portal tertawan (hotel/WiFi lapangan terbang) untuk menunjukkan bahawa pengguna mesti log masuk ke rangkaian sebelum mengakses tapak luaran.

RFC 6585 ↗

Kegunaan biasa

  • Rujukan untuk Reka Bentuk APISemasa mereka bentuk API REST, pilih kod status yang betul untuk setiap respons.
  • Cari Kod Kesalahan dengan CepatApabila aplikasi anda mengembalikan ralat HTTP yang membingungkan, cari apa sebenarnya maksudnya.
  • Pelajari Kod Status HTTPRujukan komprehensif untuk pelajar dan pembangun yang mempelajari HTTP dan REST.
  • Rujukan Pantas Semasa InsidenSemasa insiden pengeluaran, cari dengan cepat maksud setiap kod status.
  • Rujukan untuk dokumentasi APISemasa menulis dokumentasi API, pautan ke penerangan berwibawa bagi kod status yang anda kembalikan.

Cara ia berfungsi

Alat ini ialah rujukan sisi-klien dibina sekitar jadual carian berkod tetap 63 kod status HTTP merentasi kesemua lima kelas (1xx–5xx), setiap satu dianotasikan dengan nombor RFC penentunya. Tiada panggilan pelayan, tiada API luaran, dan tiada permintaan rangkaian — semua penapisan dan paparan berlaku dalam pelayar menggunakan kaedah tatasusunan dan rentetan terbina dalam JavaScript.

  1. 1
    Jadual carian dimuatkan
    Set penuh 63 kod status berdaftar IANA dibenamkan terus dalam alat ini sebagai tatasusunan JavaScript, setiap entri membawa kod berangka, nama Inggeris kanonik, kelas kategori, dan RFC khusus yang mentakrifkannya (cth. RFC 9110 untuk kebanyakan kod HTTP/1.1, RFC 6585 untuk 429 Too Many Requests, RFC 2324 untuk 418 I'm a Teapot).
  2. 2
    Penapis berjalan dalam memori
    Semasa anda menaip atau memilih penapis kategori, Array.filter JavaScript berjalan atas senarai dalam-memori, memadankan pertanyaan anda dengan nombor kod status, nama kanonik, dan kedua-dua rentetan penerangan pendek dan panjang menggunakan String.includes — tiada kelewatan debounce, tiada pergi-balik pelayan.
  3. 3
    Butiran berkembang dengan pautan RFC
    Setiap hasil dipaparkan sebagai elemen HTML details/summary. Mengembangkan entri mendedahkan penjelasan bentuk-panjang dan pautan terus ke RFC berautoriti pada rfc-editor.org, supaya anda boleh membaca teks spesifikasi tepat bagi mana-mana kod.
  4. 4
    Pautan dalam dan salinan papan keratan
    Membuka entri mengemas kini hash URL kepada nombor kod (cth. #404), menjadikan halaman boleh dikongsi dan mesra-tandabuku. Butang salin menulis rentetan kanonik (cth. '404 Not Found') ke papan keratan melalui API navigator.clipboard pelayar.

Alat berkaitan

Soalan lazim