Apakah Carian Kod Status HTTP?
Kod status HTTP ialah nombor tiga digit yang dihantar pelayan web bersama setiap respons, memberitahu klien (pelayar, aplikasi, atau pengguna API) sama ada permintaan berjaya, perlu diubah hala, atau gagal — dan mengapa. Kod ini diseragamkan oleh IETF dan digunakan secara sama di setiap pelayan web, pelayar, dan bahasa pengaturcaraan, menjadikannya salah satu rujukan nyahpepijat yang paling universal dalam pembangunan perisian.
Alat carian ini merangkumi kod yang paling kerap ditemui dalam semua lima kategori — makluman (1xx), kejayaan (2xx), ubah hala (3xx), ralat klien (4xx), dan ralat pelayan (5xx) — dengan penjelasan mudah tentang maksud sebenar setiap satu dalam amalan, bukan sekadar takrifan RFC yang formal.
Bila Menggunakan Kalkulator Ini
- Menyahpepijat integrasi API di mana permintaan gagal dan anda perlu memahami maksud sebenar kod status
- Memutuskan kod status HTTP yang hendak dikembalikan daripada API anda sendiri untuk keadaan ralat tertentu
- Mengajar atau mempelajari asas HTTP dalam kursus atau bootcamp pembangunan web
- Menulis middleware pengendalian ralat yang perlu membezakan antara kes 4xx dan 5xx yang berbeza
- Menyiasat sebab ubah hala tidak berfungsi dengan menyemak sama ada 301 atau 302 dikembalikan
- Menyelesaikan masalah CORS di mana pelayar menunjukkan ralat rangkaian tetapi pelayan mengembalikan 200
Langkah:
- Taip kod status (seperti 404) atau kata kunci (seperti "forbidden") ke dalam kotak carian.
- Tapis mengikut kategori menggunakan butang 1xx-5xx jika anda ingin menyemak julat tertentu.
- Baca penerangan mudah tentang maksud kod itu dan bila ia biasanya dikembalikan.
- Gunakan ini sebagai rujukan pantas semasa menyahpepijat respons API atau membina pengendalian ralat.
Rumus
1xx: Makluman — permintaan diterima, proses diteruskan
2xx: Berjaya — permintaan diterima dan diterima dengan jayanya
3xx: Ubah Hala — tindakan lanjut diperlukan untuk melengkapkan permintaan
4xx: Ralat Klien — permintaan mengandungi sintaks buruk atau tidak dapat dipenuhi
5xx: Ralat Pelayan — pelayan gagal memenuhi permintaan yang sah
Kes Penggunaan
- Memahami dengan pantas kod status yang tidak dikenali yang dikembalikan oleh API yang anda integrasikan
- Memutuskan kod status yang hendak dikembalikan daripada API anda sendiri untuk keadaan ralat tertentu
- Menyahpepijat sebab permintaan gagal dengan menyemak implikasi sebenar sesuatu kod
- Mengajar atau mempelajari asas HTTP dalam kursus pembangunan web
- Menulis logik pengendalian ralat yang tepat yang membezakan antara kes 4xx dan 5xx yang berbeza
Faedah Utama
- Setiap kod status yang biasa digunakan dalam satu rujukan yang boleh dicari
- Penjelasan mudah, bukan sekadar perkataan RFC yang formal
- Tapis serta-merta mengikut kategori (1xx hingga 5xx)
- Percuma, pantas, tiada pendaftaran diperlukan
Tips Pro
- Khaskan kod 5xx hanya untuk kegagalan di bahagian pelayan — jangan sesekali menggunakannya untuk menandakan ralat input klien
- Gunakan 429 dengan pengepala Retry-After apabila menyekat kadar, supaya klien yang berkelakuan baik tahu bila hendak mencuba semula
- Utamakan 404 daripada halaman ralat generik setiap kali sumber benar-benar tidak wujud — lebih baik untuk pengguna dan enjin carian
- Apabila mereka bentuk API, pilih kod 4xx yang khusus (422, 409, 400) daripada menjadikan segala-galanya 400 generik
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 ubah hala yang sepatutnya kekal (301), menjejaskan SEO
- Memperlakukan semua ralat 4xx dan 5xx sama dalam pengendalian ralat di sisi klien dan bukannya bercabang mengikut kod tertentu
Istilah Utama
- Status line: Baris pertama respons HTTP, mengandungi kod status dan frasa sebab yang ringkas
- Idempotent: Sifat kaedah HTTP tertentu di mana mengulang permintaan yang sama memberi kesan yang sama seperti melakukannya sekali
- Rantaian ubah hala: Urutan beberapa ubah hala yang diikuti pelayar sebelum sampai ke sumber akhir
- Sekatan kadar: Menghadkan bilangan permintaan yang boleh dibuat klien dalam tetingkap masa tertentu, selalunya ditandakan dengan 429
Konsep Berkaitan
- Pemformat JSON:
- Pengesah JSON:
- Penguji Regex:
- Pengekod/Penyahkod URL:
- Pengekod/Penyahkod Base64:
Contoh
Mencari "429" mengembalikan "Too Many Requests" — kod yang dikembalikan API apabila anda melebihi had kadar, memberitahu anda untuk memperlahankan dan mencuba semula selepas kelewatan.
Mentafsir Hasil
Kod status HTTP dikumpulkan kepada lima kelas mengikut digit pertama. 1xx adalah makluman dan jarang dilihat dalam kod aplikasi. 2xx mengesahkan kejayaan — 200 OK ialah yang paling biasa, tetapi 201 Created dan 204 No Content juga kerap dalam API REST. 3xx mengendalikan ubah hala, dengan 301 (kekal) dan 302 (sementara) menjadi yang paling penting.
Ralat 4xx menunjukkan ada masalah dengan permintaan klien. Yang paling biasa ialah 400 Bad Request (sintaks rosak), 401 Unauthorized (tidak disahkan), 403 Forbidden (tidak dibenarkan), 404 Not Found (sumber tidak wujud), dan 429 Too Many Requests (had kadar dilebihi). Penggunaan kod 4xx khusus yang betul menjadikan API anda jauh lebih mudah dinyahpepijat berbanding mengembalikan 400 generik untuk semua perkara.
Ralat 5xx bermakna pelayan gagal. 500 ialah ralat dalaman umum, 502 Bad Gateway menunjukkan masalah pada pelayan huluan, dan 503 Service Unavailable biasanya bermakna pelayan terlebih beban atau ditutup untuk penyelenggaraan. Apabila menyahpepijat ralat 5xx, semak log pelayan dan bukannya respons di sisi klien, kerana kod status sahaja jarang mendedahkan punca sebenar.

