Statuscodes für JSON-Antworten setzen

Jede HTTP-Antwort enthält einen Statuscode, der Erfolg oder Fehlschlag signalisiert. Ihr JSON-Body erläutert die Details, aber der Code gibt zuerst die Richtung vor. 🚦

Wenn Sie nur jsonify zurückgeben, sendet Flask 200 OK. Das ist ideal für eine erfolgreiche Abfrage, aber andere Aktionen verdienen ihren eigenen Code.

Um einen Code auszuwählen, geben Sie ein Tupel aus der JSON-Antwort und der Zahl zurück. Flask interpretiert das zweite Element als den zu sendenden HTTP-Status.

Wenn eine Anfrage einen neuen Datensatz erstellt, antworten Sie mit 201 Created. Dadurch erfährt der Client, dass die Ressource nun existiert – was 200 allein nicht vermitteln würde.

Wenn das angeforderte Element nicht existiert, geben Sie einen JSON-Body mit 404 zurück. Der Client erkennt, dass die Ressource fehlt, und nicht, dass der Server ausgefallen ist.

Wenn ein Client ungültige Daten sendet, antworten Sie mit 400 Bad Request. Ergänzen Sie eine JSON-Nachricht, die genau erklärt, was schiefgelaufen ist.

Codes im Bereich 2xx bedeuten Erfolg. 200 steht für Abfragen, 201 für Erstellungen und 204 signalisiert Erfolg ohne zurückzusendenden Body.

Codes im Bereich 4xx weisen auf den Client als Verursacher hin. 400 bedeutet fehlerhafte Eingabe, 401 nicht authentifiziert und 403 Zugriff verweigert.

Codes im Bereich 5xx weisen auf den Server als Verursacher hin. Ein 500 bedeutet, dass Ihr Code bei der Verarbeitung einer ansonsten gültigen Anfrage einen unbehandelten Fehler ausgelöst hat.

Sie können das Tupel auf drei Teile erweitern: Body, Status und ein Header-Dict. So können Sie in einer übersichtlichen Rückgabe zusätzliche Metadaten anhängen.

Wählen Sie für jedes Ergebnis den passenden Code und verwenden Sie ihn überall. Konsistente Statuscodes machen Ihre API vorhersehbar und angenehm zu integrieren.

Sie haben gelernt, JSON-Bodies mit dem richtigen Statuscode zu kombinieren, indem Sie ein Tupel zurückgeben und 201, 404 und 400 verwenden, damit Ihre API klar und ehrlich bleibt. ✅