Welcher HTTP-Code sollte von der REST-API zurückgegeben werden?

Question

im derzeit auf einer Website arbeiten, die Feder an der Vorderseite an Backend und AngularJS hat und wir hatten über Backend Antworten diskutiert Frontend die Nachricht von Dialogen zu handhaben, und ich habe eine Frage zu stellen:

sagen Lets ich eine API haben:

Und wenn Client eine Anfrage mit ungültigen Parametern wie eine Zeichenfolge erstellen, welcher Antwortcode sollte vom Server zurückgegeben werden? HTTP 400 ungültiger Anfrage- und Antworttext mit einer Nachricht "fromTime und toTime sollte im Timestamp-Format vorliegen" oder HTTP 200 mit derselben Nachricht?

Ich sah einige Google APIs zum Beispiel Oauth, sie geben Code 200 für eine Anfrage mit ungültigem access_token zurück, aber in unserem Projekt sollte es meiner Meinung nach HTTP 400 sein, weil Javascript Erfolgs- und Fehlerrückrufe hat, ist es besser für es Pop nur eine rote Farbe Dialog mit der Nachricht im Inneren anstelle von einem HTTP 200 Code dann noch den Inhalt der Nachricht zu überprüfen?

Alle Anregungen und Meinungen sind willkommen.

Danke!

Answer 1

Ja, Sie haben Recht, der http-Code sollte 400 in Ihrem Fall sein. Ihre Diskussion hier sollte normalerweise sein, ob Sie 400 oder 422 zurückgeben müssen. Dazu können Sie die akzeptierte Antwort für diese Frage SO überprüfen 400 vs 422 response to POST of data

Answer 2

Sie sollten einen 400 Fehler für eine ungültige Anforderung zurückgeben. Check out this Referenz.

Der Server kann nicht oder die Anforderung nicht verarbeitet wegen etwas , die wahrgenommen wird, einen Client-Fehler (z.B. ungültige Anfrage Syntax, ungültige Anforderungsnachricht Framing oder täuschende Anfrage routing).

haben Sie einen Blick auf RFC7231#section-6

Ein Client muss die Klasse von jedem Statuscode verstehen, durch die erste Ziffer

angegeben als

und

4xx (Client Error): Die Anfrage enthält schlechte Syntax oder nicht

Bad Syntax etwas sein kann erfüllt werden, wie Sie in Ihrer Frage erwähnt haben (eine Anforderung mit ungültigen Parametern zu machen, wie ein String).

Ich halte diese beiden Referenzen praktisch, wenn ich RESTful APIs bin der Gestaltung, könnte hilfreich sein für Sie auch:

1. https://httpstatuses.com/
2. http://www.restapitutorial.com/httpstatuscodes.html

Answer 3

Ich denke, es ist etwas mit dem zu tun hat wie die Parameter verwendet werden. Wenn Sie die Ressource verwenden, sollte ein 404 zurückgegeben werden. Wenn die Daten einfach nicht gültig sind, entscheiden wir uns, einen 409-Status für die Anfrage festzulegen. Es kann wegen fehlender/ungültiger Parameter nicht zu 100% gefüllt werden.

HTTP-Statuscode „409 Conflict“ war für uns ein guter Versuch, weil es Definition erfordern genügend Informationen für den Benutzer zu erkennen die Quelle des Konflikts einzubeziehen.

Referenz: w3.org/Protocols/

Edit: In jedem Fall ist der Statuscode 200 ist hier falsch, da ein Fehler aufgetreten ist. Als Antwort können Sie dann spezifische Informationen wie folgt zurückgeben:

{ 
    "errors": [ 
    { 
    "userMessage": "Sorry, the parameter xxx is not valid", 
    "internalMessage": "Invalid Time", 
    "code": 34, 
    "more info": "http://localhost/" 
    } 
    ] 
}