Carian Kod Status HTTP

Cari mana-mana kod status HTTP — 200, 404, 500, dan segalanya di antaranya — dengan penjelasan bahasa mudah tentang maksudnya dan bila pelayan mengembalikannya.

Apakah Carian Kod Status HTTP?

Kod status HTTP ialah nombor tiga digit yang dihantar oleh pelayan web bersama setiap respons, memberitahu pelanggan (pelayar, aplikasi, atau pengguna API) sama ada permintaan berjaya, memerlukan pengalihan, atau gagal — dan sebabnya. Ia distandardkan oleh IETF dan digunakan secara sama rata di setiap pelayan web, pelayar, dan bahasa pengaturcaraan, menjadikannya salah satu rujukan penyahpepijatan paling universal dalam pembangunan perisian.

Alat carian ini merangkumi kod yang paling biasa ditemui merentas kesemua lima kategori — maklumat (1xx), berjaya (2xx), pengalihan (3xx), ralat pelanggan (4xx), dan ralat pelayan (5xx) — dengan penjelasan bahasa mudah tentang maksud sebenar setiap satu dalam praktik, bukan sekadar definisi RFC formal.

Rumus

1xx: Maklumat — permintaan diterima, proses diteruskan

2xx: Berjaya — permintaan berjaya diterima dan diterima pakai

3xx: Pengalihan — tindakan lanjut diperlukan untuk melengkapkan permintaan

4xx: Ralat Pelanggan — permintaan mengandungi sintaks salah atau tidak dapat dipenuhi

5xx: Ralat Pelayan — pelayan gagal memenuhi permintaan yang sah

Cara Mengira

Taip kod status (seperti 404) atau kata kunci (seperti "forbidden") ke dalam kotak carian.
Tapis mengikut kategori menggunakan butang 1xx-5xx jika anda mahu melayari julat tertentu.
Baca penjelasan bahasa mudah tentang maksud kod tersebut dan bila ia biasanya dikembalikan.
Gunakan ini sebagai rujukan pantas semasa menyahpepijat respons API atau membina pengendalian ralat.

Contoh

Mencari "429" mengembalikan "Too Many Requests" — kod yang dikembalikan API apabila anda melebihi had kadar, memberitahu anda untuk perlahankan dan cuba semula selepas kelewatan.

Faedah Utama

Setiap kod status yang biasa digunakan dalam satu rujukan yang boleh dicari
Penjelasan bahasa mudah, bukan sekadar perkataan RFC formal
Tapis serta-merta mengikut kategori (1xx hingga 5xx)
Percuma, pantas, tiada pendaftaran diperlukan

Kesilapan Biasa

Mengembalikan 200 OK untuk permintaan yang sebenarnya gagal, menyembunyikan ralat daripada alat pemantauan
Mengelirukan 401 (tidak disahkan) dengan 403 (disahkan tetapi tidak dibenarkan)
Menggunakan 302 untuk pengalihan yang sepatutnya kekal (301), menjejaskan SEO
Melayan semua ralat 4xx dan 5xx sama dalam pengendalian ralat sisi klien tanpa bercabang mengikut kod tertentu

Tips Pro

Simpan kod 5xx secara ketat untuk kegagalan sisi pelayan sahaja — jangan sekali-kali gunakannya untuk menandakan ralat input pelanggan
Gunakan 429 dengan header Retry-After semasa mengehadkan kadar, supaya pelanggan yang berkelakuan baik tahu bila untuk cuba semula
Utamakan 404 berbanding halaman ralat generik apabila sesuatu sumber sememangnya tidak wujud — lebih baik untuk pengguna dan enjin carian
Semasa mereka bentuk API, pilih kod 4xx tertentu (422, 409, 400) dan bukannya menetapkan segalanya kepada 400 generik

Istilah Utama

Status line: Baris pertama respons HTTP, mengandungi kod status dan frasa sebab yang ringkas
Idempotent: Ciri kaedah HTTP tertentu di mana mengulang permintaan yang sama memberi kesan yang sama seperti melakukannya sekali
Redirect chain: Urutan berbilang pengalihan yang diikuti pelayar sebelum sampai ke sumber akhir
Rate limiting: Mengehadkan berapa banyak permintaan yang boleh dibuat pelanggan dalam tempoh masa tertentu, sering ditandakan dengan 429

Kegunaan Biasa

Memahami dengan cepat kod status yang tidak biasa yang dikembalikan oleh API yang anda integrasikan
Memutuskan kod status mana yang perlu dikembalikan daripada API anda sendiri untuk keadaan ralat tertentu
Menyahpepijat sebab permintaan gagal dengan menyemak apa yang sebenarnya dimaksudkan oleh kod tertentu
Mengajar atau mempelajari asas HTTP dalam kursus pembangunan web
Menulis logik pengendalian ralat yang tepat yang membezakan antara kes 4xx dan 5xx yang berbeza

Soalan Lazim

Apakah maksud julat kod status HTTP yang berbeza?

Kod 1xx bersifat maklumat, 2xx bermaksud berjaya, 3xx menunjukkan pengalihan, 4xx bermaksud pelanggan membuat kesilapan (seperti meminta halaman yang tiada), dan 5xx bermaksud pelayan itu sendiri gagal memenuhi permintaan yang sah.

Apakah beza antara 401 dan 403?

401 Unauthorized bermaksud anda belum disahkan (atau kelayakan anda tidak sah) — pelayan tidak tahu siapa anda. 403 Forbidden bermaksud pelayan tahu siapa anda tetapi anda tiada kebenaran untuk mengakses sumber tersebut.

Mengapa kadangkala saya nampak 200 untuk halaman yang jelas gagal dimuatkan?

Ini biasanya bermaksud pelayan mengembalikan respons HTTP yang sah (justeru 200 OK) tetapi kandungan peringkat aplikasi respons tersebut menerangkan ralat — corak biasa dalam API yang meletakkan butiran ralat dalam badan respons dan bukannya kod status.

Apakah beza antara pengalihan 301 dan 302?

301 Moved Permanently memberitahu pelayar dan enjin carian untuk mengemas kini rekod mereka dan menggunakan URL baharu selepas ini. 302 Found menandakan pengalihan sementara — URL asal sepatutnya masih digunakan untuk permintaan akan datang.