400 BAD meminta makna kode kesalahan HTTP?

Saya memiliki permintaan JSON yang saya posting ke URL HTTP.

Hal ini harus diperlakukan sebagai 400mana requestedResourcelapangan ada tapi "Roman"adalah nilai yang tidak valid untuk bidang ini?

[{requestedResource:"Roman"}] 

Hal ini harus diperlakukan sebagai 400mana "blah"lapangan tidak ada sama sekali?

[{blah:"Roman"}]

A 400 berarti bahwa permintaan salah. Dengan kata lain, aliran data yang dikirim oleh klien ke server tidak mengikuti aturan.

Dalam kasus REST API dengan payload JSON, 400's biasanya, dan dengan benar saya katakan, digunakan untuk menunjukkan bahwa JSON tidak valid dalam beberapa cara sesuai dengan spesifikasi API untuk layanan.

Dengan logika itu, kedua skenario yang Anda berikan harus 400-an.

Bayangkan saja ini XML dan bukan JSON. Dalam kedua kasus, XML tidak akan pernah melewati validasi skema - baik karena elemen yang tidak terdefinisi atau nilai elemen yang tidak tepat. Itu akan menjadi permintaan yang buruk. Kesepakatan yang sama di sini.

Dari w3.org

10.4.1 400 Permintaan Buruk

Permintaan tidak dapat dipahami oleh server karena sintaksis yang salah. Klien TIDAK HARUS mengulangi permintaan tanpa modifikasi.

Memilih kode respons HTTP adalah tugas yang cukup mudah dan dapat dijelaskan dengan aturan sederhana. Satu-satunya bagian rumit yang sering dilupakan adalah paragraf 6.5 dari RFC 7231:

Kecuali ketika menanggapi permintaan HEAD, server HARUS mengirim representasi yang berisi penjelasan tentang situasi kesalahan, dan apakah itu kondisi sementara atau permanen.

Aturannya adalah sebagai berikut:

1. Jika permintaan berhasil, kembalikan kode 2xx (3xx untuk redirect). Jika ada kesalahan logika internal pada server, lalu kembalikan 5xx. Jika ada yang salah dalam permintaan klien, maka kembalikan kode 4xx.
2. Cari melalui kode respons yang tersedia dari kategori yang dipilih. Jika salah satu dari mereka memiliki nama yang cocok dengan situasi Anda, Anda dapat menggunakannya. Kalau tidak, hanya mundur ke kode x00 (200, 400, 500). Jika Anda ragu, mundur ke kode x00.
3. Kembalikan deskripsi kesalahan di badan respons. Untuk kode 4xx harus berisi informasi yang cukup bagi pengembang klien untuk memahami alasannya dan memperbaiki klien. Untuk 5xx karena alasan keamanan, tidak ada rincian yang harus diungkapkan.
4. Jika klien perlu membedakan kesalahan yang berbeda dan memiliki reaksi yang berbeda bergantung padanya, tentukan format kesalahan yang dapat dibaca dan dikembangkan mesin dan gunakan di mana-mana di API Anda. Merupakan praktik yang baik untuk melakukannya sejak awal.
5. Perlu diingat bahwa pengembang klien dapat melakukan hal-hal aneh dan mencoba mengurai string yang Anda kembalikan sebagai deskripsi yang dapat dibaca manusia. Dan dengan mengubah string Anda akan menghancurkan klien yang ditulis dengan buruk. Jadi selalu sediakan deskripsi yang dapat dibaca mesin dan cobalah untuk tidak melaporkan informasi tambahan dalam teks.

Jadi dalam kasus Anda, saya akan mengembalikan 400 kesalahan dan sesuatu seperti ini jika "Roman" diperoleh dari input pengguna dan klien harus memiliki reaksi spesifik:

{
    "error_type" : "unsupported_resource",
    "error_description" : "\"Roman\" is not supported"
}

atau kesalahan yang lebih umum, jika situasi seperti itu adalah kesalahan logika yang buruk pada klien dan tidak diharapkan, kecuali pengembang membuat kesalahan:

{
    "error_type" : "malformed_json",
    "error_description" : "\"Roman\" is not supported for \"requestedResource\" field"
}

Dalam kedua kasus tidak ada "sintaksis cacat". Semantik yang salah. Oleh karena itu, IMHO 400 tidak pantas. Sebagai gantinya, akan lebih tepat untuk mengembalikan 200 bersama dengan beberapa jenis objek kesalahan seperti { "error": { "message": "Unknown request keyword" } }atau apa pun.

Pertimbangkan jalur pemrosesan klien. Kesalahan dalam sintaksis (misalnya JSON tidak valid) adalah kesalahan dalam logika program, dengan kata lain bug dari beberapa jenis, dan harus ditangani sesuai, dengan cara yang mirip dengan 403, katakanlah; dengan kata lain, sesuatu yang buruk telah salah.

Kesalahan dalam nilai parameter, di sisi lain, adalah kesalahan semantik, mungkin karena mengatakan input pengguna yang divalidasi dengan buruk. Ini bukan kesalahan HTTP (meskipun saya kira itu bisa menjadi 422). Jalur pemrosesan akan berbeda.

Sebagai contoh, di jQuery, saya lebih suka tidak harus menulis penangan kesalahan tunggal yang berhubungan dengan kedua hal seperti 500 dan beberapa kesalahan semantik khusus aplikasi. Kerangka kerja lain, Ember for one, juga memperlakukan kesalahan HTTP seperti 400 dan 500 secara identik sebagai kegagalan besar, yang mengharuskan programmer untuk mendeteksi apa yang terjadi dan bercabang tergantung pada apakah itu kesalahan "nyata" atau tidak.

Menggunakan 400kode status untuk tujuan lain apa pun selain menunjukkan bahwa permintaan yang salah benar-benar salah.

Jika payload permintaan berisi urutan byte yang tidak dapat diuraikan sebagai application/json(jika server mengharapkan format data itu), kode status yang sesuai adalah 415:

Server menolak untuk melayani permintaan karena entitas permintaan dalam format yang tidak didukung oleh sumber daya yang diminta untuk metode yang diminta.

Jika payload permintaan secara sintaksis benar tetapi semantik salah, 422kode respons non-standar dapat digunakan, atau 403kode status standar :

Server mengerti permintaan itu, tetapi menolak untuk memenuhinya. Otorisasi tidak akan membantu dan permintaan TIDAK HARUS diulang.

Pikirkan tentang harapan.

Sebagai aplikasi klien, Anda berharap tahu jika ada masalah di sisi server. Jika server perlu melakukan kesalahan saat blahhilang atau requestedResourcenilainya salah dari kesalahan 400 akan sesuai.

Sebagai pelengkap, bagi mereka yang mungkin memenuhi masalah yang sama dengan saya, saya menggunakan $.ajaxuntuk mengirim data formulir ke server dan saya juga mendapat 400kesalahan pada awalnya.

Asumsikan saya memiliki variabel javascript,

var formData = {
    "name":"Gearon",
    "hobby":"Be different"
    }; 

Jangan gunakan variabel formDatasecara langsung sebagai nilai kunci dataseperti di bawah ini:

$.ajax({
    type: "post",
    dataType: "json",
    url: "http://localhost/user/add",
    contentType: "application/json",
    data: formData,
    success: function(data, textStatus){
        alert("Data: " + data + "\nStatus: " + status); 
    }
});

Sebaliknya, gunakan JSON.stringify untuk merangkum formDataseperti di bawah ini:

$.ajax({
    type: "post",
    dataType: "json",
    url: "http://localhost/user/add",
    contentType: "application/json",
    data: JSON.stringify(formData),
    success: function(data, textStatus){
        alert("Data: " + data + "\nStatus: " + status); 
    }
});

Lagi pula, seperti yang telah diilustrasikan orang lain, kesalahannya adalah karena server tidak dapat mengenali permintaan yang menyebabkan sintaksis salah bentuk, saya hanya memunculkan contoh saat latihan. Semoga bermanfaat bagi seseorang.

Pertama periksa URL itu mungkin salah, jika sudah benar maka periksa badan permintaan yang Anda kirim, kemungkinan penyebabnya adalah permintaan yang Anda kirim tidak ada sintaks benar.

Untuk menguraikan, periksa karakter khusus dalam string permintaan. Jika itu (char khusus) sedang digunakan ini adalah akar penyebab kesalahan ini.

coba salin permintaan dan analisis masing-masing dan setiap data tag.