400 BAD Anfrage HTTP Fehlercode Bedeutung?

Ich habe eine JSON-Anfrage, die ich an eine HTTP-URL sende.

Sollte dies so behandelt werden, als 400ob ein requestedResourceFeld vorhanden wäre, aber "Roman"ein ungültiger Wert für dieses Feld ist?

[{requestedResource:"Roman"}] 

Sollte dies so behandelt werden, als 400ob ein "blah"Feld überhaupt nicht existiert?

[{blah:"Roman"}]

Ein 400 bedeutet, dass die Anforderung fehlerhaft war. Mit anderen Worten, der vom Client an den Server gesendete Datenstrom entsprach nicht den Regeln.

Im Fall einer REST-API mit einer JSON-Nutzlast werden normalerweise 400 verwendet, und ich würde zu Recht sagen, dass der JSON gemäß der API-Spezifikation für den Dienst in irgendeiner Weise ungültig ist.

Nach dieser Logik sollten beide von Ihnen bereitgestellten Szenarien 400 sein.

Stellen Sie sich stattdessen vor, dies wäre eher XML als JSON. In beiden Fällen würde das XML niemals die Schemaüberprüfung bestehen - entweder aufgrund eines undefinierten Elements oder eines falschen Elementwerts. Das wäre eine schlechte Anfrage. Gleiches Angebot hier.

Von w3.org

10.4.1 400 Bad Request

Die Anforderung konnte vom Server aufgrund einer fehlerhaften Syntax nicht verstanden werden. Der Client sollte die Anfrage NICHT ohne Änderungen wiederholen.

Die Auswahl eines HTTP-Antwortcodes ist eine recht einfache Aufgabe und kann durch einfache Regeln beschrieben werden. Der einzige schwierige Teil, der oft vergessen wird, ist Absatz 6.5 aus RFC 7231:

Außer bei der Beantwortung einer HEAD-Anfrage sollte der Server eine Darstellung senden, die eine Erläuterung der Fehlersituation enthält und angibt, ob es sich um eine vorübergehende oder eine dauerhafte Bedingung handelt.

Die Regeln lauten wie folgt:

1. Wenn die Anforderung erfolgreich war, geben Sie 2xx-Code zurück (3xx für die Umleitung). Wenn auf einem Server ein interner Logikfehler aufgetreten ist, geben Sie 5xx zurück. Wenn in der Clientanforderung etwas nicht stimmt, geben Sie den 4xx-Code zurück.
2. Durchsuchen Sie den verfügbaren Antwortcode aus der ausgewählten Kategorie. Wenn einer von ihnen einen Namen hat, der gut zu Ihrer Situation passt, können Sie ihn verwenden. Ansonsten einfach auf x00-Code (200, 400, 500) zurückgreifen. Wenn Sie Zweifel haben, greifen Sie auf x00-Code zurück.
3. Fehlerbeschreibung im Antworttext zurückgeben. Für 4xx-Codes muss es genügend Informationen enthalten, damit der Cliententwickler den Grund versteht und den Client repariert. Aus Sicherheitsgründen müssen aus Sicherheitsgründen keine Details bekannt gegeben werden.
4. Wenn der Client unterschiedliche Fehler unterscheiden und abhängig davon unterschiedlich reagieren muss, definieren Sie ein maschinenlesbares und erweiterbares Fehlerformat und verwenden Sie es überall in Ihrer API. Es ist eine gute Praxis, dies von Anfang an zu tun.
5. Denken Sie daran, dass Client-Entwickler möglicherweise seltsame Dinge tun und versuchen, Zeichenfolgen zu analysieren, die Sie als lesbare Beschreibung zurückgeben. Und wenn Sie die Zeichenfolgen ändern, brechen Sie solche schlecht geschriebenen Clients. Geben Sie daher immer eine maschinenlesbare Beschreibung an und vermeiden Sie es, zusätzliche Informationen im Text zu melden.

In Ihrem Fall habe ich also 400 Fehler zurückgegeben und so etwas, wenn "Roman" aus Benutzereingaben erhalten wird und der Client eine bestimmte Reaktion haben muss:

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

oder ein allgemeinerer Fehler, wenn eine solche Situation ein fehlerhafter Logikfehler in einem Client ist und nicht erwartet wird, es sei denn, der Entwickler hat etwas falsch gemacht:

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

In keinem Fall ist die "Syntax fehlerhaft". Es ist die Semantik, die falsch ist. Daher ist meiner Meinung nach eine 400 unangemessen. Stattdessen wäre es angebracht, eine 200 zusammen mit einer Art Fehlerobjekt wie { "error": { "message": "Unknown request keyword" } }oder was auch immer zurückzugeben.

Betrachten Sie die Client-Verarbeitungspfade. Ein Fehler in der Syntax (z. B. ungültiger JSON) ist ein Fehler in der Logik des Programms, dh ein Fehler, und sollte entsprechend behandelt werden, ähnlich wie beispielsweise bei einem 403; Mit anderen Worten, etwas Schlimmes ist schiefgegangen.

Ein Fehler in einem Parameterwert ist andererseits ein Fehler der Semantik, möglicherweise aufgrund einer schlecht validierten Benutzereingabe. Es ist kein HTTP-Fehler (obwohl es vermutlich ein 422 sein könnte). Der Verarbeitungspfad wäre anders.

In jQuery würde ich es beispielsweise vorziehen, keinen einzigen Fehlerbehandler schreiben zu müssen, der sich sowohl mit 500 als auch mit einem app-spezifischen semantischen Fehler befasst. Andere Frameworks, zum Beispiel Ember, behandeln HTTP-Fehler wie 400er und 500er ebenfalls als große Fettfehler, sodass der Programmierer erkennen muss, was vor sich geht, und verzweigen muss, je nachdem, ob es sich um einen "echten" Fehler handelt oder nicht.

Die Verwendung von 400Statuscodes für einen anderen Zweck als die Angabe, dass die Anforderung fehlerhaft ist, ist einfach falsch.

Wenn die Anforderungsnutzlast eine Bytefolge enthält, die nicht analysiert werden konnte application/json(wenn der Server dieses Datenformat erwartet), lautet der entsprechende Statuscode 415:

Der Server weigert sich, die Anforderung zu bearbeiten, da die Entität der Anforderung in einem Format vorliegt, das von der angeforderten Ressource für die angeforderte Methode nicht unterstützt wird.

Wenn die Anforderungsnutzlast syntaktisch korrekt, aber semantisch falsch ist, kann der nicht standardmäßige 422Antwortcode oder der Standardstatuscode 403verwendet werden:

Der Server hat die Anfrage verstanden, weigert sich jedoch, sie zu erfüllen. Die Autorisierung hilft nicht und die Anfrage sollte nicht wiederholt werden.

Denken Sie an Erwartungen.

Als Client-App erwarten Sie, dass Sie wissen, ob auf der Serverseite etwas schief geht. Wenn der Server einen Fehler auslösen muss, wenn er blahfehlt oder der requestedResourceWert falsch ist, ist ein Fehler von 400 angemessen.

Als Ergänzung für diejenigen, die möglicherweise das gleiche Problem wie ich haben, verwende ich, $.ajaxum Formulardaten auf dem Server zu veröffentlichen, und ich habe auch die400 Fehler erhalten.

Angenommen, ich habe eine Javascript-Variable.

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

Verwenden Sie die Variable nicht formDatadirekt als Schlüsselwert datawie folgt:

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

Verwenden Sie stattdessen JSON.stringify, um Folgendes zu kapseln formData:

$.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); 
    }
});

Wie andere bereits gezeigt haben, liegt der Fehler darin, dass der Server die Anfrage aufgrund einer fehlerhaften Syntax nicht erkennen konnte. Ich habe gerade eine Instanz in der Praxis ausgelöst. Hoffe es wäre hilfreich für jemanden.

Überprüfen Sie zuerst die URL, die möglicherweise falsch ist. Wenn sie korrekt ist, überprüfen Sie dann den Anforderungshauptteil, den Sie senden. Die mögliche Ursache ist, dass die von Ihnen gesendete Anforderung die richtige Syntax fehlt.

Überprüfen Sie zum Ausarbeiten die Anforderungszeichenfolge auf Sonderzeichen. Wenn es (Sonderzeichen) verwendet wird, ist dies die Hauptursache für diesen Fehler.

Versuchen Sie, die Anforderung zu kopieren, und analysieren Sie alle Tag-Daten.