Kod status HTTP adalah cara internet berkomunikasi antara pelayan dan pelanggan. Setiap kali penyemak imbas anda meminta halaman web, API membuat panggilan, atau pelayan memproses data, kod tiga digit ini memberitahu anda apa yang berlaku dengan tepat. Memahami kod ini adalah penting untuk pembangun web, pakar SEO, dan sesiapa yang bekerja dengan teknologi web.
Panduan komprehensif ini merangkumi semua kod status HTTP standard dari 100 hingga 511, disusun mengikut kategori. Setiap kod status termasuk penjelasan praktikal, kes penggunaan dunia sebenar, panduan pelaksanaan, dan perangkap biasa yang perlu dielakkan.
Rujukan Pantas Kod Status HTTP
| Kod Status | Nama | Kategori | Lompat Ke |
|---|---|---|---|
| 100 | Continue | Informational | Butiran |
| 101 | Switching Protocols | Informational | Butiran |
| 102 | Processing | Informational | Butiran |
| 103 | Early Hints | Informational | Butiran |
| 200 | OK | Success | Butiran |
| 201 | Created | Success | Butiran |
| 202 | Accepted | Success | Butiran |
| 203 | Non-Authoritative Information | Success | Butiran |
| 204 | No Content | Success | Butiran |
| 205 | Reset Content | Success | Butiran |
| 206 | Partial Content | Success | Butiran |
| 207 | Multi-Status | Success | Butiran |
| 208 | Already Reported | Success | Butiran |
| 226 | IM Used | Success | Butiran |
| 300 | Multiple Choices | Redirection | Butiran |
| 301 | Moved Permanently | Redirection | Butiran |
| 302 | Found | Redirection | Butiran |
| 303 | See Other | Redirection | Butiran |
| 304 | Not Modified | Redirection | Butiran |
| 305 | Use Proxy (Deprecated) | Redirection | Butiran |
| 307 | Temporary Redirect | Redirection | Butiran |
| 308 | Permanent Redirect | Redirection | Butiran |
| 400 | Bad Request | Client Error | Butiran |
| 401 | Unauthorized | Client Error | Butiran |
| 403 | Forbidden | Client Error | Butiran |
| 404 | Not Found | Client Error | Butiran |
| 405 | Method Not Allowed | Client Error | Butiran |
| 406 | Not Acceptable | Client Error | Butiran |
| 407 | Proxy Authentication Required | Client Error | Butiran |
| 408 | Request Timeout | Client Error | Butiran |
| 409 | Conflict | Client Error | Butiran |
| 410 | Gone | Client Error | Butiran |
| 418 | I’m a teapot | Client Error | Butiran |
| 422 | Unprocessable Entity | Client Error | Butiran |
| 429 | Too Many Requests | Client Error | Butiran |
| 451 | Unavailable For Legal Reasons | Client Error | Butiran |
| 500 | Internal Server Error | Server Error | Butiran |
| 501 | Not Implemented | Server Error | Butiran |
| 502 | Bad Gateway | Server Error | Butiran |
| 503 | Service Unavailable | Server Error | Butiran |
| 504 | Gateway Timeout | Server Error | Butiran |
| 505 | HTTP Version Not Supported | Server Error | Butiran |
| 507 | Insufficient Storage | Server Error | Butiran |
| 508 | Loop Detected | Server Error | Butiran |
| 511 | Network Authentication Required | Server Error | Butiran |
Respons Bermaklumat 1xx
Kod ini menunjukkan bahawa permintaan telah diterima dan proses sedang berterusan.
Apakah kod status 100?
HTTP: 100 Continue
Bila dan mengapa pelayan mengembalikannya: Pelayan berkata “Saya menerima bahagian pertama permintaan anda, dan ia kelihatan baik setakat ini - teruskan dan hantar yang selebihnya!” Ini berlaku apabila anda cuba memuat naik sesuatu yang besar (seperti video), dan pelayan ingin memeriksa sama ada anda dibenarkan memuat naik sebelum anda membuang masa menghantar keseluruhan fail.
Kes penggunaan praktikal: Memuat naik fail besar ke storan awan di mana pelayan memeriksa sama ada anda mempunyai ruang yang cukup terlebih dahulu, menghantar borang besar di mana pelayan mengesahkan log masuk anda sebelum menerima semua data, atau sebarang situasi di mana masuk akal untuk memeriksa kebenaran sebelum memindahkan banyak data.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Penyemak imbas atau aplikasi anda harus segera mula menghantar data yang selebihnya. Selalunya, ini berlaku secara automatik di belakang tabir - anda tidak akan menyedarinya berlaku.
Penyalahgunaan atau pelaksanaan yang salah: Menghantar ini ke penyemak imbas lama yang tidak memahaminya, menghantarnya secara rawak apabila tiada siapa yang memintanya, atau melupakan untuk memeriksa sama ada pelanggan sebenarnya mahukan proses dua langkah ini sebelum menggunakannya.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 101?
HTTP: 101 Switching Protocols
Bila dan mengapa pelayan mengembalikannya: Pelayan bersetuju untuk menukar cara ia berkomunikasi dengan anda. Ia seperti beralih dari menghantar mesej teks ke panggilan telefon - anda meminta untuk menaik taraf sambungan, dan pelayan berkata “Sudah tentu, mari kita lakukan!”
Kes penggunaan praktikal: Apabila aplikasi sembang menaik taraf dari HTTP normal ke WebSocket untuk pemesejan masa nyata, apabila penyemak imbas meminta untuk menggunakan versi HTTP yang lebih pantas, atau apabila mana-mana aplikasi perlu beralih ke kaedah komunikasi berbeza untuk ciri yang lebih baik.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Segera mula menggunakan protokol komunikasi baharu. Ia seperti menukar bahasa pertengahan perbualan - sebaik sahaja anda berdua bersetuju, anda mula bercakap dalam bahasa baharu dengan segera.
Penyalahgunaan atau pelaksanaan yang salah: Menukar tanpa diminta, cuba menukar kepada sesuatu yang pelayan sebenarnya tidak menyokong, atau melupakan untuk menyatakan protokol mana yang anda tukar.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 102?
HTTP: 102 Processing
Bila dan mengapa pelayan mengembalikannya: Pelayan berkata “Saya masih mengusahakan permintaan anda - jangan berputus asa dengan saya!” Ini digunakan apabila sesuatu mengambil masa yang sangat lama untuk diproses, jadi pelayan menghantar mesej ini untuk menghalang anda daripada menganggap ia terhempas.
Kes penggunaan praktikal: Menukar fail video besar ke format berbeza, memproses beratus fail sekaligus, menjalankan laporan kompleks yang mengambil masa beberapa minit untuk dijana, atau sebarang operasi yang mengambil masa lebih lama daripada biasa untuk diselesaikan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Terus menunggu dengan sabar. Pelayan mungkin menghantar beberapa mesej “masih bekerja” ini sebelum akhirnya memberi anda hasil sebenar. Jangan cuba semula permintaan - itu hanya akan memulakan keseluruhan proses semula.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan ini untuk operasi pantas yang tidak memerlukannya, menghantar terlalu banyak mesej “masih bekerja”, atau melupakan untuk menghantar respons akhir selepas mengatakan anda sedang memproses.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 103?
HTTP: 103 Early Hints
Bila dan mengapa pelayan mengembalikannya: Pelayan memberi anda petunjuk awal tentang sumber yang mungkin anda perlukan tidak lama lagi. Ia seperti restoran memberitahu anda “sementara saya menyediakan pesanan anda, anda mungkin ingin menyediakan napkin dan peralatan anda.”
Kes penggunaan praktikal: Memberitahu penyemak imbas untuk mula memuatkan fail CSS dan JavaScript semasa pelayan menyediakan HTML, memuatkan fon yang halaman akan perlukan, atau memanaskan sambungan ke pelayan lain yang halaman akan gunakan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Mula memuatkan sumber yang dicadangkan di latar belakang semasa menunggu respons sebenar. Ini menjadikan halaman terasa lebih pantas kerana sebahagian kerja bermula awal.
Penyalahgunaan atau pelaksanaan yang salah: Menghantar petunjuk tetapi tidak pernah menghantar respons sebenar, mencadangkan sumber yang sebenarnya tidak diperlukan, atau membebankan pelanggan dengan terlalu banyak petunjuk pramuatan yang tidak perlu.
Mozilla.org Developer Doc untuk rujukan tambahan
Kejayaan 2xx
Kod ini menunjukkan bahawa permintaan telah berjaya diterima, difahami, dan diterima.
Apakah kod status 200?
HTTP: 200 OK
Bila dan mengapa pelayan mengembalikannya: Ini adalah respons “segala-galanya berfungsi dengan sempurna”. Pelayan menemui apa yang anda mahukan, melakukan apa yang anda minta, dan inilah hasilnya. Ia adalah mesej kejayaan yang paling biasa yang anda akan lihat.
Kes penggunaan praktikal: Memuatkan mana-mana halaman web dengan jayanya, mendapatkan data dari API, memuat turun fail, menghantar borang yang berfungsi dengan betul, atau pada asasnya setiap kali permintaan berjaya tanpa sebarang isu.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Gunakan data yang kembali - tunjukkan halaman web, proses data JSON, simpan fail, atau apa sahaja yang masuk akal untuk aplikasi anda. Ini adalah respons “normal” yang segala-galanya direka untuk mengendalikan.
Penyalahgunaan atau pelaksanaan yang salah: Mengatakan “200 OK” tetapi memasukkan mesej ralat dalam respons (mengelirukan!), menggunakan 200 apabila anda mencipta sesuatu yang baharu (gunakan 201 sebaliknya), atau mengembalikan 200 tanpa data apabila data dijangka.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 201?
HTTP: 201 Created
Bila dan mengapa pelayan mengembalikannya: Pelayan berjaya mencipta sesuatu yang baharu berdasarkan permintaan anda. Ia bukan hanya “OK” - ia khususnya “Saya membuat perkara baharu yang anda minta!”
Kes penggunaan praktikal: Mencipta akaun pengguna baharu, menyiarkan tweet atau kemas kini status baharu, memuat naik fail yang disimpan sebagai sumber baharu, menambah produk baharu ke troli beli-belah, atau setiap kali permintaan anda menghasilkan sesuatu yang baharu disimpan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Cari pengepala Location yang biasanya memberitahu anda di mana untuk mencari perkara yang baru dicipta. Anda mungkin mengalihkan ke sumber baharu atau mengemas kini UI anda untuk menunjukkan bahawa penciptaan berjaya.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 201 apabila mengemas kini perkara sedia ada (itulah tujuan 200), melupakan untuk memasukkan lokasi sumber baharu, atau menggunakan 201 apabila tiada sesuatu yang sebenarnya dicipta.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 202?
HTTP: 202 Accepted
Bila dan mengapa pelayan mengembalikanya: Pelayan menerima permintaan anda tetapi belum selesai memprosesnya lagi. Ia seperti menghantar pakaian untuk dobi - mereka mengambil pakaian anda dan memberi anda resit, tetapi pencucian belum selesai lagi.
Kes penggunaan praktikal: Menghantar e-mel (diterima untuk penghantaran tetapi belum dihantar lagi), memulakan eksport data besar yang akan dihantar melalui e-mel apabila sedia, kerja pemprosesan video, atau sebarang tugas yang dimasukkan ke dalam barisan untuk pemprosesan kemudian.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Jangan harapkan hasil segera. Anda akan memerlukan cara lain untuk memeriksa sama ada kerja selesai - mungkin poll endpoint lain, tunggu e-mel, atau periksa untuk pemberitahuan webhook.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 202 untuk perkara yang sebenarnya sudah selesai, tidak menyediakan sebarang cara untuk memeriksa status kemudian, atau menggunakan 202 apabila tugas mungkin gagal (tanpa memberi amaran kepada pelanggan tentang kemungkinan ini).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 203?
HTTP: 203 Non-Authoritative Information
Bila dan mengapa pelayan mengembalikannya: Permintaan berjaya, tetapi respons telah diubah oleh sesuatu di tengah (seperti proksi atau cache). Ia seperti bermain telefon - mesej berjaya disampaikan, tetapi ia mungkin berubah sedikit sepanjang perjalanan.
Kes penggunaan praktikal: Apabila proksi syarikat menambah atau membuang pengepala tertentu, apabila pelayan caching mengubah respons untuk menjimatkan lebar jalur, atau apabila penapis kandungan menyesuaikan apa yang anda lihat berdasarkan dasar.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Gunakan respons secara normal, tetapi ketahui bahawa ia mungkin tidak tepat seperti yang pelayan asal hantar. Ia masih sah, hanya berpotensi diubah.
Penyalahgunaan atau pelaksanaan yang salah: Tidak telus tentang pengubahsuaian, menggunakan 203 apabila tiada sesuatu yang sebenarnya diubah, atau mengubah respons dengan cara yang merosakkan fungsi.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 204?
HTTP: 204 No Content
Bila dan mengapa pelayan mengembalikannya: Pelayan berjaya melakukan apa yang anda minta tetapi tidak mempunyai apa-apa untuk dihantar balik. Ia seperti berjaya memadam sesuatu - pemadaman berfungsi, tetapi tiada apa-apa untuk ditunjukkan kepada anda kerana ia sudah tiada!
Kes penggunaan praktikal: Memadam rekod, mengemas kini tetapan di mana anda tidak memerlukan data pengesahan kembali, menyimpan pilihan secara senyap di latar belakang, atau sebarang tindakan yang berjaya di mana badan respons adalah sia-sia.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Anggap ia sebagai kejayaan tetapi jangan harapkan sebarang data. Sempurna untuk permintaan AJAX di mana anda hanya perlu tahu sesuatu berfungsi. Halaman tidak sepatutnya dimuat semula atau berubah melainkan JavaScript anda memutuskan untuk mengemas kini sesuatu.
Penyalahgunaan atau pelaksanaan yang salah: Termasuk data respons dengan 204 (itu tidak dibenarkan!), menggunakan 204 apabila pelanggan mungkin ingin melihat data yang dikemas kini, atau menggunakan 204 untuk ralat.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 205?
HTTP: 205 Reset Content
Bila dan mengapa pelayan mengembalikannya: Pelayan memberitahu aplikasi anda untuk mengosongkan borangnya atau menetapkan semula paparannya. Ia seperti berjaya menghantar tinjauan dan borang secara automatik mengosongkan dirinya untuk orang seterusnya.
Kes penggunaan praktikal: Selepas menghantar borang kemasukan data yang perlu digunakan berulang kali, melengkapkan tinjauan yang sepatutnya ditetapkan semula untuk responden seterusnya, atau sebarang situasi di mana UI harus kembali ke keadaan permulaannya selepas kejayaan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Kosongkan semua medan borang, tetapkan semula paparan dokumen, atau kembalikan antara muka ke keadaan asalnya. Tiada data datang dengan respons ini - ia hanya arahan untuk menetapkan semula.
Penyalahgunaan atau pelaksanaan yang salah: Menghantar data dengan respons 205 (ia sepatutnya kosong), menggunakan 205 apabila anda sebenarnya tidak mahu borang dikosongkan, atau menggunakannya apabila 204 mudah lebih baik.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 206?
HTTP: 206 Partial Content
Bila dan mengapa pelayan mengembalikannya: Pelayan hanya menghantar sebahagian daripada fail kerana itulah yang anda minta. Ia seperti meminta muka surat 50-60 buku berbanding keseluruhan buku.
Kes penggunaan praktikal: Menstrim video di mana anda boleh melompat ke bahagian yang berbeza, menyambung semula muat turun yang terganggu dari tempat ia berhenti, memuat turun fail besar dalam bahagian, atau melaksanakan ciri “muat lebih” dengan cekap.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Proses kandungan separa dan berpotensi meminta lebih banyak bahagian jika diperlukan. Pemain video menggunakan ini untuk mencari, dan pengurus muat turun menggunakannya untuk menyambung.
Penyalahgunaan atau pelaksanaan yang salah: Menghantar 206 apabila tiada siapa meminta kandungan separa, menghantar julat byte yang salah, tidak menyokong permintaan julat apabila ia akan membantu, atau mengacaukan pengepala Content-Range.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 207?
HTTP: 207 Multi-Status
Bila dan mengapa pelayan mengembalikannya: Berbilang operasi telah dilakukan dan setiap satu mempunyai hasilnya sendiri. Ia seperti menghantar kumpulan permohonan pekerjaan dan mendapat respons individu untuk setiap satu dalam satu sampul surat.
Kes penggunaan praktikal: Operasi pukal di mana anda mengemas kini berbilang item sekaligus, operasi WebDAV pada berbilang fail, permintaan API kelompok, atau setiap kali anda perlu melaporkan hasil individu untuk berbilang operasi.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Huraikan badan respons (biasanya XML) untuk melihat hasil individu bagi setiap operasi. Sesetengah mungkin berjaya sementara yang lain gagal, dan anda perlu mengendalikan setiap satu dengan sewajarnya.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 207 untuk operasi tunggal, tidak menstruktur respons berbilang status dengan betul, atau menggunakannya apabila semua operasi mempunyai hasil yang sama (hanya gunakan kod status tunggal itu sebaliknya).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 208?
HTTP: 208 Already Reported
Bila dan mengapa pelayan mengembalikannya: Dalam respons berbilang status, ini menunjukkan maklumat tentang sumber ini telah disertakan lebih awal. Ia seperti mengatakan “lihat di atas” untuk mengelak mengulang diri anda.
Kes penggunaan praktikal: Apabila menyenaraikan kandungan direktori yang termasuk pautan simbolik, mencegah gelung tak terhingga dalam operasi rekursif, atau mengelakkan maklumat pendua dalam respons WebDAV yang kompleks.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Langkau pemprosesan sumber ini kerana anda sudah mengendalikannya lebih awal dalam respons. Ini menghalang pemprosesan berganda dan gelung tak terhingga.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 208 di luar konteks berbilang status yang betul, menandakan perkara sebagai “sudah dilaporkan” apabila ia tidak, atau mencipta respons yang mengelirukan dengan menggunakan status ini secara berlebihan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 226?
HTTP: 226 IM Used
Bila dan mengapa pelayan mengembalikannya: Pelayan mengaplikasikan satu atau lebih transformasi kepada respons. Ia seperti memesan dokumen dan menerima versi yang dimampatkan atau dioptimumkan untuk menjimatkan lebar jalur.
Kes penggunaan praktikal: Pengekodan delta di mana hanya perubahan sejak kali terakhir dihantar, sistem mampatan yang mengubah kandungan dengan pantas, atau sebarang transformasi penjimatan lebar jalur yang pelanggan minta.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Proses kandungan yang diubah menggunakan kaedah yang ditunjukkan dalam pengepala. Pelanggan perlu memahami transformasi untuk menggunakan respons dengan betul.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 226 tanpa menunjukkan transformasi apa yang diaplikasikan, mengaplikasikan transformasi yang pelanggan tidak minta, atau menggunakan 226 untuk mampatan standard (yang tidak memerlukan status khas).
Mozilla.org Developer Doc untuk rujukan tambahan
Pengalihan 3xx
Kod ini menunjukkan bahawa tindakan selanjutnya perlu diambil untuk melengkapkan permintaan.
Apakah kod status 300?
HTTP: 300 Multiple Choices
Bila dan mengapa pelayan mengembalikannya: Terdapat berbilang versi sumber yang diminta dan pelayan tidak dapat memilih satu secara automatik. Ia seperti meminta “manual” apabila terdapat versi dalam bahasa yang berbeza.
Kes penggunaan praktikal: Apabila kandungan tersedia dalam berbilang bahasa atau format, apabila terdapat versi berbeza untuk peranti yang berbeza, atau apabila pelayan benar-benar tidak dapat memutuskan versi mana yang anda mahukan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Persembahkan pilihan kepada pengguna atau pilih satu berdasarkan pilihan (seperti tetapan bahasa). Respons harus menyenaraikan semua pilihan yang tersedia.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 300 apabila pelayan dapat memilih lalai yang munasabah, tidak jelas mempersembahkan pilihan yang tersedia, atau menggunakannya untuk pengalihan mudah (gunakan 301/302 sebaliknya).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 301?
HTTP: 301 Moved Permanently
Bila dan mengapa pelayan mengembalikannya: Sumber telah berpindah secara kekal ke alamat baharu. Ia seperti apabila perniagaan berpindah ke lokasi baharu dan meletakkan tanda penghantaran kekal - kemas kini buku alamat anda!
Kes penggunaan praktikal: Apabila laman web menstruktur semula URL mereka secara kekal, berpindah dari HTTP ke HTTPS, apabila syarikat menukar jenama dan menukar domain, atau menyatukan berbilang halaman menjadi satu untuk organisasi yang lebih baik.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Pergi secara automatik ke URL baharu dan ingat ia untuk kali seterusnya. Penyemak imbas mengemas kini tandabuku, dan enjin carian mengemas kini indeks mereka untuk menunjuk ke lokasi baharu.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 301 untuk perpindahan sementara (gunakan 302 sebaliknya), mencipta rantaian pengalihan yang melantun pengguna, atau menggunakan 301 apabila anda mungkin ingin menukarnya kembali kemudian.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 302?
HTTP: 302 Found
Bila dan mengapa pelayan mengembalikannya: Sumber berada di lokasi yang berbeza buat sementara waktu. Ia seperti tanda kedai yang berkata “Kami di pasar tani hari ini” - mereka akan kembali ke tempat biasa esok.
Kes penggunaan praktikal: Mengalihkan pengguna semasa penyelenggaraan tapak, ujian A/B di mana sesetengah pengguna pergi ke versi yang berbeza, promosi bermusim yang mengalihkan ke halaman khas, atau pengimbangan beban antara pelayan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Pergi ke lokasi sementara buat masa ini, tetapi terus menggunakan URL asal untuk permintaan masa depan. Jangan kemas kini tandabuku atau rujukan kekal.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 302 untuk perpindahan kekal (gunakan 301 untuk itu), mencipta gelung pengalihan di mana A menghantar ke B dan B menghantar kembali ke A, atau menggunakan 302 apabila anda khususnya perlu memelihara kaedah HTTP (gunakan 307).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 303?
HTTP: 303 See Other
Bila dan mengapa pelayan mengembalikannya: Selepas memproses permintaan anda (biasanya POST), pelayan mahu anda melihat halaman yang berbeza menggunakan GET. Ia seperti menghantar borang dan dialihkan ke halaman “terima kasih”.
Kes penggunaan praktikal: Selepas menghantar borang, alihkan ke halaman pengesahan; selepas membuat pembayaran, alihkan ke resit; setiap kali anda ingin menghalang penyerahan berganda apabila pengguna memuat semula halaman.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Buat permintaan GET baru ke URL baharu. Ini menghalang penyerahan semula secara tidak sengaja jika pengguna memuat semula halaman, kerana memuat semula hanya akan memuatkan semula halaman akhir, bukan menghantar semula borang.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 303 apabila anda ingin memelihara kaedah asal (gunakan 307), menggunakannya untuk pengalihan kekal (gunakan 301), atau melupakan bahawa pengalihan akan sentiasa menggunakan GET tanpa mengira kaedah asal.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 304?
HTTP: 304 Not Modified
Bila dan mengapa pelayan mengembalikannya: Sumber tidak berubah sejak anda memintanya kali terakhir, jadi gunakan salinan cache anda. Ia seperti memeriksa sama ada dokumen dikemas kini dan diberitahu “tidak, masih sama.”
Kes penggunaan praktikal: Caching penyemak imbas di mana ia memeriksa sama ada fail imej/CSS/JavaScript berubah, respons API yang jarang berubah, atau sebarang situasi di mana anda ingin menjimatkan lebar jalur dengan tidak menghantar semula data yang tidak berubah.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Gunakan versi cache yang anda sudah ada. Tiada data baharu datang dengan respons ini - ia hanya mengesahkan salinan cache anda masih baik.
Penyalahgunaan atau pelaksanaan yang salah: Menghantar data dengan 304 (ia mesti kosong), mengatakan “tidak diubahsuai” apabila ia sebenarnya diubahsuai, atau tidak mengendalikan dengan betul pengepala khas yang menjadikan ini berfungsi.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 305?
HTTP: 305 Use Proxy
Bila dan mengapa pelayan mengembalikannya: Kod status ini sudah lapuk dan tidak boleh digunakan. Ia mempunyai masalah keselamatan dan telah ditinggalkan oleh komuniti web.
Kes penggunaan praktikal: Tiada - kod status ini telah bersara dan tidak sepatutnya digunakan dalam sebarang aplikasi moden.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Pelanggan moden harus mengabaikan kod status ini kerana kebimbangan keselamatan. Ia adalah artifak sejarah.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan kod status ini langsung adalah kesilapan. Ia sudah lapuk atas sebab keselamatan yang baik dan tidak sepatutnya muncul dalam aplikasi moden.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 307?
HTTP: 307 Temporary Redirect
Bila dan mengapa pelayan mengembalikannya: Alihkan sementara ke URL lain, tetapi tidak seperti 302, pelanggan mesti menggunakan kaedah yang sama. Jika permintaan asal adalah POST, pengalihan juga mesti POST.
Kes penggunaan praktikal: Endpoint API yang sedang dalam penyelenggaraan yang perlu memelihara kaedah, pengimbangan beban yang mengekalkan integriti permintaan, atau sebarang pengalihan sementara di mana menukar dari POST ke GET akan merosakkan perkara.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Alihkan ke URL baharu menggunakan kaedah dan badan yang sama seperti permintaan asal. Ini lebih ketat daripada pengalihan 302.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 307 untuk perpindahan kekal (gunakan 308), menggunakannya apabila pemeliharaan kaedah tidak penting (302 lebih mudah), atau tidak menyedari bahawa pelanggan mesti menghantar semula badan permintaan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 308?
HTTP: 308 Permanent Redirect
Bila dan mengapa pelayan mengembalikannya: Seperti 301, tetapi menjamin kaedah tidak akan berubah. Jika anda POST ke URL lama, anda mesti POST ke URL baharu juga.
Kes penggunaan praktikal: Memindahkan endpoint API secara kekal yang menerima POST/PUT/DELETE, menstruktur semula perkhidmatan RESTful sambil mengekalkan integriti kaedah, atau sebarang perpindahan kekal di mana kaedah HTTP mesti dipelihara.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Kemas kini rujukan secara kekal untuk menggunakan URL baharu, dan sentiasa gunakan kaedah HTTP yang sama seperti permintaan asal apabila mengikuti pengalihan.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 308 untuk perpindahan sementara (gunakan 307), menggunakannya apabila pemeliharaan kaedah tidak penting (301 lebih disokong secara meluas), atau melupakan ini adalah kod status yang lebih baharu yang pelanggan lama mungkin tidak faham.
Mozilla.org Developer Doc untuk rujukan tambahan
Ralat Pelanggan 4xx
Kod ini menunjukkan bahawa pelanggan nampaknya telah membuat ralat.
Apakah kod status 400?
HTTP: 400 Bad Request
Bila dan mengapa pelayan mengembalikannya: Permintaan anda adalah cacat atau tidak sah dalam beberapa cara. Ia seperti mengisi borang dengan e-mel anda dalam medan nombor telefon - pelayan tidak dapat memprosesnya kerana ia tidak masuk akal.
Kes penggunaan praktikal: JSON tidak sah dalam badan permintaan, parameter yang diperlukan hilang, jenis data yang salah (menghantar teks apabila nombor dijangka), URL cacat, atau sebarang ralat sintaks dalam permintaan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Jangan cuba semula permintaan yang sama - ia akan gagal lagi. Betulkan masalah terlebih dahulu. Periksa badan respons untuk butiran tentang apa yang salah dan betulkannya sebelum cuba lagi.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 400 untuk masalah pengesahan (gunakan 401), mengembalikan 400 untuk ralat pelayan (gunakan 5xx), memberi mesej ralat kabur yang tidak membantu membetulkan masalah, atau menggunakan 400 sebagai tangkapan semua untuk sebarang ralat.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 401?
HTTP: 401 Unauthorized
Bila dan mengapa pelayan mengembalikannya: Anda perlu log masuk atau berikan kelayakan untuk mengakses sumber ini. Ia seperti cuba memasuki kawasan ahli sahaja tanpa menunjukkan kad keahlian anda.
Kes penggunaan praktikal: Mengakses endpoint API yang dilindungi tanpa token, sesi log masuk tamat tempoh, kunci API hilang, atau sebarang permintaan ke sumber yang memerlukan anda membuktikan siapa anda.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Maklumkan pengguna untuk log masuk, alihkan ke halaman log masuk, atau dapatkan kelayakan yang sah sebelum mencuba semula. Untuk API, dapatkan token pengesahan yang segar.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 401 apabila kelayakan sah tetapi tidak mencukupi (gunakan 403), melupakan untuk memasukkan maklumat tentang cara mengesahkan, atau mengelirukan pengesahan (siapa anda) dengan kebenaran (apa yang anda dibenarkan lakukan).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 403?
HTTP: 403 Forbidden
Bila dan mengapa pelayan mengembalikannya: Pelayan memahami siapa anda tetapi tidak akan membenarkan anda mengakses sumber ini. Ia seperti menunjukkan ID anda untuk memasuki kawasan VIP tetapi diberitahu anda tidak dalam senarai.
Kes penggunaan praktikal: Cuba mengakses ciri pentadbir sebagai pengguna biasa, cuba melihat data peribadi pengguna lain, sekatan geografi (kandungan tidak tersedia di negara anda), atau penyekatan alamat IP.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Jangan buang masa mencuba semula dengan kelayakan yang sama - ia tidak akan berfungsi. Tunjukkan mesej “akses dinafikan” dan mungkin terangkan cara mendapat akses yang betul jika berkaitan.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 403 apabila pengguna tidak log masuk (gunakan 401), menggunakan 403 untuk sumber yang tidak wujud untuk menyembunyikan kewujudan mereka (boleh dibahaskan - mungkin gunakan 404), atau tidak jelas tentang mengapa akses dilarang.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 404?
HTTP: 404 Not Found
Bila dan mengapa pelayan mengembalikannya: Pelayan tidak dapat mencari apa-apa pada URL yang anda minta. Ia seperti pergi ke alamat jalan di mana hanya ada tanah kosong - sama ada anda salah alamat, atau apa sahaja yang pernah ada di sana sudah tiada.
Kes penggunaan praktikal: Menaip URL dengan salah (seperti gooogle.com bukannya google.com), mengklik tandabuku lama ke halaman yang telah dipadam, mengikut pautan rosak dari laman web lain, membuat kesilapan taip dalam endpoint API, atau cuba mengakses fail yang dipindahkan atau dinamakan semula.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Tunjukkan halaman ralat yang membantu pengguna memikirkan apa yang perlu dilakukan seterusnya. Halaman 404 yang baik termasuk kotak carian, pautan ke halaman popular, cara untuk melaporkan pautan rosak, atau bahkan mesej menarik untuk menjadikan ralat kurang mengecewakan.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 404 apabila akses dinafikan (gunakan 403 untuk “anda tidak boleh lihat ini”), mengembalikan 404 untuk perkara yang sengaja dibuang selamanya (pertimbangkan 410 “Gone”), menunjukkan halaman ralat generik yang tidak membantu, atau menggunakan 404 untuk menyembunyikan bahawa sesuatu wujud dari pengguna yang tidak diberi kuasa (walaupun ini boleh dibahaskan untuk keselamatan).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 405?
HTTP: 405 Method Not Allowed
Bila dan mengapa pelayan mengembalikannya: Sumber wujud tetapi tidak menyokong kaedah HTTP yang anda gunakan. Ia seperti cuba menolak pintu yang hanya dibuka dengan menarik - pintu wujud, anda hanya perlu menggunakannya dengan betul.
Kes penggunaan praktikal: Cuba DELETE sumber yang hanya baca, menghantar POST ke endpoint yang hanya menerima GET, cuba PUT pada sumber yang tidak boleh dikemas kini, atau menggunakan kaedah tersuai yang pelayan tidak menyokong.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Periksa pengepala Allow untuk melihat kaedah mana yang disokong, kemudian cuba semula dengan kaedah yang sesuai. Jangan terus mencuba kaedah yang sama - ia tidak disokong.
Penyalahgunaan atau pelaksanaan yang salah: Tidak termasuk pengepala Allow yang diperlukan menyenaraikan kaedah yang disokong, menggunakan 405 apabila sumber tidak wujud (gunakan 404), atau mengembalikan 405 untuk kaedah yang pelayan sepatutnya sokong tetapi belum dilaksanakan (pertimbangkan 501).
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 406?
HTTP: 406 Not Acceptable
Bila dan mengapa pelayan mengembalikannya: Pelayan tidak dapat menyediakan sumber dalam format yang anda akan terima. Ia seperti meminta menu dalam bahasa Perancis di restoran yang hanya mempunyai versi Bahasa Inggeris dan Sepanyol.
Kes penggunaan praktikal: Meminta JSON dari endpoint yang hanya menyediakan XML, meminta format imej yang pelayan tidak sokong, kegagalan rundingan bahasa, atau sebarang ketidakpadanan rundingan kandungan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Ubah pengepala Accept anda untuk meminta format yang pelayan boleh sediakan, atau kendalikan format yang tersedia. Respons mungkin menyenaraikan format apa yang tersedia.
Penyalahgunaan atau pelaksanaan yang salah: Terlalu ketat tentang format apabila anda boleh menyediakan lalai yang munasabah, menggunakan 406 untuk ralat bukan rundingan kandungan, atau tidak jelas menunjukkan format apa yang tersedia.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 407?
HTTP: 407 Proxy Authentication Required
Bila dan mengapa pelayan mengembalikannya: Pelayan proksi antara anda dan destinasi memerlukan pengesahan. Ia seperti perlu menunjukkan ID kepada pengawal keselamatan sebelum anda boleh sampai ke bangunan yang anda ingin masuki.
Kes penggunaan praktikal: Pelayan proksi korporat yang memerlukan log masuk pekerja, gerbang rangkaian yang memerlukan pengesahan, perkhidmatan proksi berbayar yang memerlukan kelayakan, atau sebarang persediaan proksi yang disahkan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Sahkan dengan pelayan proksi (bukan pelayan destinasi) menggunakan kaedah yang dinyatakan dalam pengepala Proxy-Authenticate, kemudian cuba semula permintaan asal.
Penyalahgunaan atau pelaksanaan yang salah: Mengelirukan ini dengan pengesahan biasa 401, tidak termasuk pengepala Proxy-Authenticate, atau menggunakan 407 apabila ia adalah pelayan destinasi (bukan proksi) yang memerlukan pengesahan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 408?
HTTP: 408 Request Timeout
Bila dan mengapa pelayan mengembalikannya: Pelayan menunggu anda menghantar permintaan lengkap, tetapi anda mengambil masa terlalu lama. Ia seperti mula memesan di restoran tetapi berhenti sebentar terlalu lama sehingga pelayan pergi.
Kes penggunaan praktikal: Sambungan rangkaian yang perlahan menyebabkan kelewatan, muat naik fail besar melalui sambungan yang lemah, aplikasi pelanggan yang beku semasa penghantaran permintaan, atau gangguan rangkaian semasa menghantar data.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Anda boleh cuba semula permintaan, sebaiknya dengan sambungan yang lebih baik atau muatan yang lebih kecil. Pertimbangkan untuk memecah permintaan besar kepada bahagian yang lebih kecil atau memperbaiki keadaan rangkaian.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 408 apabila pelayan perlahan (itu 504), menetapkan tamat masa yang tidak munasabah singkat, atau menggunakan 408 untuk tamat masa peringkat aplikasi berbanding peringkat rangkaian.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 409?
HTTP: 409 Conflict
Bila dan mengapa pelayan mengembalikannya: Permintaan anda bercanggah dengan keadaan semasa sumber. Ia seperti cuba membuat nama pengguna yang sudah diambil - operasi masuk akal, tetapi ia tidak boleh dilakukan sekarang.
Kes penggunaan praktikal: Cuba membuat rekod pendua, mengedit dokumen yang orang lain sedang edit, konflik versi dalam sistem kolaboratif, atau melanggar peraturan perniagaan (seperti tempahan berganda sumber).
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Selesaikan konflik dengan memilih nilai yang berbeza, menggabungkan perubahan, atau menunggu konflik hilang. Respons harus menerangkan apa konfliknya dan cara menyelesaikannya.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 409 untuk ralat pengesahan (pertimbangkan 422), tidak menerangkan cara menyelesaikan konflik, menggunakan 409 untuk isu kebenaran (gunakan 403), atau melaporkan konflik yang sebenarnya tidak boleh diselesaikan oleh pelanggan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 410?
HTTP: 410 Gone
Bila dan mengapa pelayan mengembalikannya: Sumber pernah wujud di sini tetapi telah sengaja dibuang dan tidak akan kembali. Ia seperti melawat bangunan yang telah dirobohkan - ia bukan hanya tutup sementara, ia hilang secara kekal.
Kes penggunaan praktikal: Artikel atau catatan yang dipadam kerana pelanggaran dasar, produk yang dihentikan selama-lamanya, versi API lama yang telah ditamatkan, atau sebarang kandungan yang sengaja dan secara kekal dibuang.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Buang tandabuku, kemas kini pautan, dan maklumkan pengguna kandungan hilang secara kekal. Enjin carian harus membuang URL ini dari indeks mereka. Jangan terus memeriksa - ia tidak akan kembali.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 410 untuk pembuangan sementara (gunakan 503), menggunakan 410 apabila anda mungkin memulihkan kandungan, menggunakan 410 untuk perkara yang tidak pernah wujud (gunakan 404), atau tidak pasti pembuangan adalah kekal.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 418?
HTTP: 418 I’m a teapot
Bila dan mengapa pelayan mengembalikannya: Ini adalah kod status jenaka dari RFC April Fools’ tentang mengawal periuk kopi. Ia bermaksud “Saya adalah teko, dan anda meminta saya membancuh kopi, yang tidak boleh saya lakukan.”
Kes penggunaan praktikal: Easter egg dalam aplikasi, menunjukkan kebolehsambungan HTTP dalam kursus pengaturcaraan, menambah humor ke persekitaran pembangunan/ujian, atau sebagai respons suka-suka dalam konteks yang sesuai.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Kenali ia sebagai respons lucu dan kendalikan dengan sewajarnya - mungkin paparkan mesej ralat yang menyeronokkan atau imejan berkaitan teh. Jangan harapkan ini dalam persekitaran pengeluaran yang serius.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 418 untuk ralat sebenar dalam sistem pengeluaran, menggunakannya secara berlebihan sehingga menjadi menjengkelkan, atau mengembalikannya kepada pengguna yang tidak akan memahami jenaka itu.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 422?
HTTP: 422 Unprocessable Entity
Bila dan mengapa pelayan mengembalikannya: Format permintaan anda betul, tetapi kandungannya tidak masuk akal. Ia seperti mengisi borang dengan betul tetapi memasukkan data yang mustahil - seperti berumur 300 tahun atau dilahirkan pada masa depan.
Kes penggunaan praktikal: Kegagalan pengesahan borang (e-mel tanpa simbol @), pelanggaran peraturan perniagaan (tarikh tamat sebelum tarikh mula), ralat semantik dalam permintaan API, atau sebarang ralat logik dalam data yang diformatkan dengan betul.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Baca butiran ralat untuk memahami pengesahan apa yang gagal, betulkan data untuk memenuhi keperluan, dan hantar semula. Strukturnya baik; kandungannya perlu penyesuaian.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 422 untuk ralat sintaks (gunakan 400), tidak menyediakan butiran ralat pengesahan khusus, menggunakan 422 untuk isu pengesahan/kebenaran, atau tidak konsisten tentang apa yang mencetuskan 422 vs 400.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 429?
HTTP: 429 Too Many Requests
Bila dan mengapa pelayan mengembalikannya: Anda menghantar terlalu banyak permintaan terlalu cepat. Ia seperti memanggil seseorang berulang kali - akhirnya mereka akan berhenti menjawab dan memberitahu anda untuk perlahan.
Kes penggunaan praktikal: Had kadar API (cth, 100 permintaan sejam), mencegah penyalahgunaan atau serangan DDoS, melindungi pelayan daripada ditimpa, atau menguatkuasakan dasar penggunaan adil.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Berhenti membuat permintaan dan tunggu. Periksa pengepala Retry-After untuk melihat bila anda boleh cuba lagi. Laksanakan backoff eksponen - tunggu lebih lama antara setiap percubaan.
Penyalahgunaan atau pelaksanaan yang salah: Tidak termasuk pengepala Retry-After untuk membimbing pelanggan, menetapkan had terlalu rendah untuk penggunaan normal, menggunakan 429 untuk jenis beban berlebihan lain (pertimbangkan 503), atau tidak jelas mendokumenkan had kadar.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 451?
HTTP: 451 Unavailable For Legal Reasons
Bila dan mengapa pelayan mengembalikannya: Kandungan disekat kerana keperluan undang-undang. Dinamakan sempena “Fahrenheit 451” Ray Bradbury tentang penapisan, status ini menunjukkan penyekatan kerajaan atau undang-undang.
Kes penggunaan praktikal: Kandungan disekat oleh perintah mahkamah, notis takedown DMCA, sekatan geografi kerana undang-undang tempatan, keperluan penapisan kerajaan, atau sebarang penyekatan kandungan yang dimandatkan secara undang-undang.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Maklumkan pengguna bahawa kandungan disekat secara undang-undang. Respons mungkin termasuk butiran tentang siapa yang menuntut penyekatan (jika dibenarkan secara undang-undang untuk dikongsi).
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 451 untuk penyekatan bukan undang-undang (gunakan kod 4xx yang sesuai), tidak telus tentang penyekatan undang-undang apabila boleh, atau menggunakan 451 untuk dasar kandungan sukarela berbanding keperluan undang-undang.
Mozilla.org Developer Doc untuk rujukan tambahan
Ralat Pelayan 5xx
Kod ini menunjukkan bahawa pelayan gagal memenuhi permintaan yang sah.
Apakah kod status 500?
HTTP: 500 Internal Server Error
Bila dan mengapa pelayan mengembalikannya: Sesuatu tidak kena di pihak pelayan, dan ia tidak tahu cara mengendalikannya. Ia seperti daftar tunai terhempas di kedai - masalahnya bukan dengan kaedah pembayaran anda, sistem mereka sahaja rosak.
Kes penggunaan praktikal: Apabila sambungan pangkalan data gagal, apabila terdapat pepijat dalam kod pelayan, apabila pelayan kehabisan memori, atau sebarang kemalangan yang tidak dijangka yang pengaturcara tidak jangka.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Beritahu pengguna sesuatu tidak kena dan cadangkan cuba lagi kemudian. Anda mungkin cuba semula secara automatik selepas kelewatan, kerana ralat ini selalunya sementara.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 500 untuk ralat pengguna (gunakan kod 4xx untuk itu), menunjukkan mesej ralat terperinci kepada pengguna (risiko keselamatan!), tidak mencatat butiran yang cukup untuk membetulkan masalah, atau menggunakan 500 sebagai tangkapan semua malas untuk sebarang ralat.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 501?
HTTP: 501 Not Implemented
Bila dan mengapa pelayan mengembalikannya: Pelayan tidak menyokong fungsi yang anda minta. Ia seperti meminta kalkulator asas untuk melukis graf fungsi - ia memahami apa yang anda mahukan tetapi tidak mempunyai ciri itu.
Kes penggunaan praktikal: Menggunakan kaedah HTTP yang pelayan tidak kenali, meminta ciri yang dirancang tetapi belum dibina, pelayan lama yang tidak menyokong fungsi moden, atau kaedah tersuai yang tidak dilaksanakan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Jangan cuba semula permintaan ini - pelayan tidak dapat mengendalikannya. Gunakan pendekatan yang berbeza atau periksa sama ada terdapat cara alternatif untuk mencapai apa yang anda perlukan.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 501 untuk ciri yang dilumpuhkan sementara (gunakan 503), menggunakan 501 untuk kaedah yang anda kenali tetapi tidak benarkan (gunakan 405), atau menggunakan 501 sebagai alasan untuk ciri yang hilang yang sepatutnya dilaksanakan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 502?
HTTP: 502 Bad Gateway
Bila dan mengapa pelayan mengembalikannya: Pelayan yang bertindak sebagai gateway atau proksi menerima respons tidak sah dari pelayan hulu. Ia seperti meminta seseorang menyampaikan mesej, tetapi mereka kembali berkata “orang yang saya tanya memberi saya karut.”
Kes penggunaan praktikal: Pengimbang beban tidak dapat mencapai pelayan backend, gateway API menerima ralat dari mikroservis, proksi terbalik mendapat respons cacat, atau CDN tidak dapat mengambil dari pelayan asal.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Ini biasanya sementara, jadi cuba semula selepas kelewatan singkat. Masalahnya adalah antara pelayan, bukan dengan permintaan anda, jadi mencuba semula mungkin berfungsi sebaik sahaja mereka membetulkan isu komunikasi mereka.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 502 untuk ralat pelayan asal sendiri (gunakan 500), tidak membezakan antara senario “tidak dapat dicapai” dan “respons tidak sah”, atau menggunakan 502 apabila gateway sendiri mempunyai masalah.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 503?
HTTP: 503 Service Unavailable
Bila dan mengapa pelayan mengembalikannya: Pelayan tidak dapat mengendalikan permintaan buat sementara waktu. Ia seperti kedai meletakkan tanda “tutup untuk penyelenggaraan” - mereka akan kembali, tetapi bukan sekarang.
Kes penggunaan praktikal: Tetingkap penyelenggaraan yang dijadualkan, situasi beban berlebihan pelayan, gangguan sementara untuk kemas kini, had kadar pada peringkat pelayan, atau sebarang ketidakupayaan sementara untuk melayan permintaan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Tunggu dan cuba semula kemudian. Periksa pengepala Retry-After untuk panduan bila untuk kembali. Laksanakan backoff eksponen untuk percubaan semula untuk mengelak daripada membebankan pelayan apabila ia kembali.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 503 untuk masalah kekal (gunakan ralat yang sesuai), tidak termasuk Retry-After apabila anda tahu berapa lama ia akan mengambil masa, menggunakan 503 untuk isu khusus pelanggan berbanding masalah seluruh pelayan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 504?
HTTP: 504 Gateway Timeout
Bila dan mengapa pelayan mengembalikannya: Pelayan yang bertindak sebagai gateway atau proksi tidak menerima respons tepat pada masanya dari pelayan hulu. Ia seperti meminta seseorang menyampaikan mesej, tetapi mereka kembali berkata “Saya tunggu dan tunggu, tetapi mereka tidak pernah bertindak balas.”
Kes penggunaan praktikal: Pertanyaan pangkalan data mengambil masa terlalu lama, perkhidmatan backend yang terbeban, isu rangkaian antara pelayan, mikroservis tidak bertindak balas dengan cukup pantas, atau sebarang tamat masa dalam komunikasi pelayan-ke-pelayan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Anda boleh cuba semula, tetapi sedar operasi mungkin mahal atau perlahan. Pertimbangkan sama ada permintaan cukup kritikal untuk dicuba semula, dan laksanakan had percubaan semula yang munasabah.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 504 apabila pelanggan perlahan (gunakan 408), menetapkan tamat masa terlalu pendek untuk operasi yang munasabah, tidak membezakan antara senario tamat masa yang berbeza, atau menggunakan 504 untuk tamat masa pelayan asal sendiri.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 505?
HTTP: 505 HTTP Version Not Supported
Bila dan mengapa pelayan mengembalikannya: Pelayan tidak menyokong versi HTTP yang digunakan dalam permintaan. Ia seperti cuba memainkan cakera Blu-ray dalam pemain DVD - pemain memahami apa yang anda mahukan tetapi tidak dapat mengendalikan format itu.
Kes penggunaan praktikal: Pelayan lama yang hanya menyokong HTTP/1.0 menerima permintaan HTTP/2, pelayan belum dinaik taraf untuk menyokong versi HTTP yang lebih baharu, atau versi HTTP tersuai/eksperimental yang pelayan tidak kenali.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Cuba semula permintaan menggunakan versi HTTP yang berbeza, biasanya berundur ke HTTP/1.1 yang disokong secara universal. Periksa versi apa yang pelayan sokong.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 505 untuk ciri yang tidak disokong dalam versi (gunakan 501), tidak cuba mengendalikan rundingan versi dengan anggun, atau menolak versi HTTP standard yang sepatutnya disokong.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 507?
HTTP: 507 Insufficient Storage
Bila dan mengapa pelayan mengembalikannya: Pelayan tidak mempunyai ruang storan yang cukup untuk melengkapkan permintaan. Ia seperti cuba menyimpan fail apabila cakera keras penuh.
Kes penggunaan praktikal: Kegagalan muat naik fail kerana cakera penuh, operasi pangkalan data mencapai kuota storan, operasi WebDAV melebihi ruang yang diperuntukkan, atau sebarang operasi yang memerlukan lebih banyak storan daripada yang tersedia.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Maklumkan pengguna tentang had storan. Mungkin perlu memadam kandungan lama, meminta lebih banyak storan, atau kurangkan saiz apa yang anda cuba simpan.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 507 untuk isu storan sementara yang akan hilang (pertimbangkan 503), tidak memantau storan dengan betul, menggunakan 507 untuk isu kuota yang tidak berkaitan dengan storan fizikal, atau tidak menyediakan maklumat tentang had storan.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 508?
HTTP: 508 Loop Detected
Bila dan mengapa pelayan mengembalikannya: Pelayan mengesan gelung tak terhingga semasa memproses permintaan. Ia seperti mengikut arahan yang berkata “lihat langkah 1” di akhir - anda akan berputar selama-lamanya.
Kes penggunaan praktikal: Operasi WebDAV dengan rujukan bulat, rantaian pengalihan yang bergelung kembali kepada diri mereka sendiri, pautan simbolik yang mencipta kitaran, atau sebarang operasi pelayan yang mengesan ia berulang tanpa henti.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Jangan cuba semula permintaan yang sama - ia akan mencapai gelung yang sama. Periksa rujukan bulat dalam struktur data anda dan betulkannya sebelum cuba lagi.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 508 untuk ralat bukan gelung, tidak melaksanakan pengesanan gelung yang betul, menggunakan 508 untuk gelung pengalihan sebelah pelanggan (yang muncul berbeza), atau mengesan positif palsu sebagai gelung.
Mozilla.org Developer Doc untuk rujukan tambahan
Apakah kod status 511?
HTTP: 511 Network Authentication Required
Bila dan mengapa pelayan mengembalikannya: Anda perlu mengesahkan dengan rangkaian itu sendiri sebelum anda boleh mengakses internet. Ia seperti perlu mendaftar masuk ke WiFi hotel sebelum anda boleh melayari mana-mana laman web.
Kes penggunaan praktikal: Halaman log masuk WiFi hotel atau lapangan terbang, portal akses rangkaian korporat, WiFi awam yang memerlukan menerima syarat perkhidmatan, atau sebarang situasi portal tawanan.
Bagaimana pelanggan perlu bertindak balas terhadap status ini: Alihkan pengguna ke halaman log masuk rangkaian (biasanya disediakan dalam respons). Sebaik sahaja mereka mengesahkan dengan rangkaian, mereka boleh cuba semula permintaan asal mereka.
Penyalahgunaan atau pelaksanaan yang salah: Menggunakan 511 untuk keperluan log masuk laman web (gunakan 401), menggunakan 511 untuk pengesahan proksi (gunakan 407), atau melaksanakan portal tawanan dengan cara yang merosakkan sambungan selamat.
Mozilla.org Developer Doc untuk rujukan tambahan