HTTP Status Code Kategorien! Bitte mit Deepl übersetzen und an Sprache des Handbuchs anpassen

https://nordicapis.com/what-do-the-http-status-codes-mean/

Die für die REST API verwendeten HTTP-Statuscodes sind durch RFC 9110 definiert

• 100 Statuscodes: Informationsantworten, die den Benutzer über wichtige Informationszustände informieren sollen,

• 200 Statuscodes: erfolgreiche Antworten, die den Benutzer darüber informieren, dass eine Anfrage erfolgreich war,

• Umleitungsantworten, die den Benutzer darüber informieren, dass eine Umleitung stattgefunden hat oder erforderlich ist, um die Anfrage in ihrer Form abzuschließen.

• 400 Statuscodes: Client-Fehlerantworten, die den Benutzer über einen Fehler auf der Clientseite informieren,

• 500 Statuscodes: Serverfehler-Antworten, die den Benutzer über einen Fehler auf der Serverseite informieren.

Während viele HTTP-Statuscodes existieren, sind nur eine Handvoll häufig genug, um regelmäßig aufzutreten. Es sollte angemerkt werden, dass nicht standardmäßige Antworten möglich sind, aber vollständig von der Server-Software implementiert werden und daher hier nicht behandelt werden.

100er Serie: Informationsantworten

Codes in dieser Serie sollen bestimmte Informationen an den Endbenutzer weiterleiten.

100 weiter

Der 100-Resüge-Code informiert den Benutzer, dass er die Anfrage in der Form fortsetzt oder trotz der Antwort fortfahren sollte, wenn diese Anfrage bereits abgeschlossen wurde. Es wird in der Regel verwendet, wenn der Server die Körpernutzlast benötigt, aber die Verbindung erkannt hat und die Anfrage gebildet wurde.

101 Schaltprotokolle

Dieser Code wird verwendet, wenn der Client einen Upgrade-Request-Header ausgestellt hat, dem Server zugestimmt hat und so das Protokoll geändert wird.

Entwickler Anwendungsfall für die 100er-Serie

Die 100 Codes sind informationsal, daher sollten sie verwendet werden, wenn eine angeschlossene Anfrage einige zusätzliche Informationen enthält, die weitergegeben werden müssen. Während die meisten Benutzer diese Codes nie sehen werden, benötigen diejenigen, die Systeme mit Ihrer API verwenden, diese Codes, um die richtige Form und Funktion zu bestätigen.

200er Serie: Erfolgreiche Antworten

200 OK

Code 200 ist vielleicht der häufigste HTTP-Code auf dieser Liste, da er der Standard-Statuscode "OK" ist, der eine erfolgreiche HTTP-Anfrage bezeichnet. Was diese Antwort bedeutet, hängt von den ergriffenen Maßnahmen ab. Zum Beispiel führt eine GET-Anfrage zu einer HTTP 200-Antwort, die auf Abruf und den zugehörigen Nachrichtenkörper hindeutet.

201

Dieser Kodex bestätigt, dass die Anfrage erfolgreich war und eine neue Ressource geschaffen wurde. Dieser Code ist am häufigsten nach einer POST- oder PUT-Anfrage.

204

Code 204 ist ein Code, der anzeigt, dass eine Anfrage erfüllt wurde, aber vom Server keine zusätzlichen Informationen zurückzugeben. Dieser Code ist am häufigsten bei Anfragen wie DELETE, wo eine Aktion bestätigt werden muss, die nicht dazu führt, dass neue Informationen mit dem Kunden geteilt werden.

Entwickler Anwendungsfall für die 200er Serie

Die Serie 200 ist eigentlich sehr nützlich, da sie nicht nur Erfolg, sondern auch den Grund für den Erfolg bedeutet. Im Fall von 201 informiert er den Kunden über den Status der neuen Ressource. Mit 204 wird etwas geschaffen, aber es gibt keine zusätzlichen Informationen, was selbst eine Art Update um den Ressourcenstatus ist.

Verwenden Sie daher die 200 Codes routinemäßig, da sie Ihren Nutzern den besten Kontext und die Sicherheit zum Erfolg ihrer Prozesse geben.

300er Serie: Umleitungsantwort

301 Dauerverzogen

Ein 301-Code zeigt an, dass der Ressourcenstandort dauerhaft geändert wurde. Die neue URL/URI wird als Teil der Antwort bereitgestellt, daher sollten Entwickler sicherstellen, dass 301s keine Endpunkte entlarven, die nicht veröffentlicht werden sollten.

304

Der 304-Statuscode weist den Client an, dass die Browser-Acched-Daten für die Nutzung gültig sind, da eine Antwort nicht geändert wurde. Im Wesentlichen lässt dieser Code den Kunden wissen, dass keine neuen Anfragen erforderlich sind und dass die vorhandenen durchgespeicherten Daten an ihrer Stelle verwendet werden können.

307 Temporärische Redirect

307 und 308 konzentrieren sich auf Umleitungen, aber 307 bedeutet entscheidend, dass diese Umleitung vorübergehender Natur ist. Der Server reagiert mit der neuen URL/URI für den Client, sagt aber, dass die HTTP-Methode für die neue Anfrage nicht geändert werden kann.

308 Dauerre Richtung

Wie 307 bedeutet dieser Code eine Umleitung, aber in diesem Fall eine, die dauerhaft ist. Es nutzt die HTTP-Antwort-Standortkopf und besteht erneut darauf, dass die HTTP-Methode in der Anfrage nicht an die neue bereitgestellte Ressource geändert wird.

Entwickler Anwendungsfall für die 300er Serie

Redirection Codes sind vielleicht eine der wichtigsten Codekategorien für API-Entwickler. Richtig formatierte Umleitung und die Kommunikation des Kontexts um diese Umleitung helfen, das Endkundenerlebnis aufzubauen. Es ist auch hilfreich für Entwickler, die APIs und Systeme erstellen, die die Implementierung nutzen.

Daher sollten Sie sehr vorsichtig sein, sicherzustellen, dass Sie die richtigen 300 Codes verwenden und die genauesten und geeignetsten Ressourcenlinks aufdecken.

400er Serie: Client Error Responses

400

Code 400 gibt an, dass ein Client-Fehler eine Anfrage erstellt hat, die der Server nicht verstehen oder verarbeiten kann. Dieser allgemeine Fehlercode kann Probleme wie fehlerhafte Anfragen, Client-Verarbeitungsfehler oder fehlende Kopf- oder Körperinformationen umfassen.

401

Dieser Statuscode zeigt an, dass eine Anfrage abgelehnt wurde, da der Server eine Authentifizierung benötigt, aber der Client diese Informationen nicht zur Verfügung gestellt hat. Wenn dieser Code ausgestellt wird, gibt es daher an, dass der Benutzer nicht ohne Angabe der angeforderten Informationen vorgehen kann.

403

Während 401 eine Ablehnung aufgrund der Authentifizierung anzeigt, schlägt 403 eine Ablehnung für jeden anderen allgemeinen Grund jenseits der Authentifizierung vor. Es gibt verschiedene Gründe dafür, einschließlich der Berechtigungsprobleme, aber die Authentifizierungsströme werden vollständig auf den 401-Code verbannt.

404

Der bei weitem häufigste Code im Web für den durchschnittlichen Benutzer ist der 404 Statuscode für viele zu einem Witz und zu einem kulturellen Touchstone geworden. 404 bedeutet, dass eine Anfrage gültig ist, aber der Server kann die Ressource nicht finden. Dies kann aus einer Vielzahl von Gründen auftreten, wie z. B. einer schlecht gebildeten Anfrage oder einer, der auf eine alte Ressourcenverbindung gerichtet ist.

409

Statuscode 409 zeigt an, dass die Anfrage in der Form mit dem aktuellen Zustand der Ressource in Konflikt steht. Zu solchen Konflikten gehören oft Versionierungs- und Obsoleszenz-Themen. Daher sollten Softwareanbieter Informationen in die Dokumentation aufnehmen, wie 409 Konflikte gelöst werden können.

410

410 ist ein interessanter Code, da er einen Fehler und einen langfristigen Zustand vermittelt. Der 410-Code besagt, dass eine angeforderte Ressource für den Kunden nicht mehr verfügbar ist und nicht mehr verfügbar sein wird. Das heißt im Grunde: „Das kann man nicht zugreifen und es in Zukunft nicht versuchen.“

Entwickler Anwendungsfall für die 400er-Serie

400 Codes sind von entscheidender Bedeutung, da sie Fehler und den Kontext des Vorfalls vermitteln. Die Serie 400 bietet so viel Kontext für einen Benutzer, nur aufgrund der Art des Codes - sie teilt mit, dass ein Fehler aufgetreten ist, und es ist nicht der Fehler des Servers, der einen beträchtlichen Teil der frühphasenbezogenen Lösung entfernt, die typischerweise auftritt, wenn Fehler behoben werden.

500 Serie: Serverfehler

500

500, ein sehr üblicher Code, bedeutet, dass ein Server eine Anfrage aufgrund eines Fehlers nicht erfüllen kann. 500 ist ein allgemeiner Fehlercode, so dass Sie, wenn dies erscheint, auf Serverprotokolle angewiesen sein müssen, um zu bestimmen, wo das Problem aufgetreten ist und aus welchem Grund. Wenn ein bestimmter Grund bekannt ist und dieser Grund durch einen bestimmten Fehlercode in der 500-Serie abgedeckt ist, wird dieser bestimmte Code anstelle eines generischen 500 angezeigt.

502 Bad Gateway

Code 502 gibt an, dass eine ungültige Antwort nach einer gültigen Anfrage erzeugt wurde. Dieser Code bezeichnet fast immer ein Problem, das außerhalb der Kontrolle des Benutzers liegt, aber gelegentlich kann er sich auf kundengespeicherte Informationen oder Routing-Daten beziehen, die gereinigt werden müssen, um die Anfrage richtig zu stellen.

503 Service nicht verfügbar

Dieser Fehlercode ist der einfachste aller HTTP-Codes, da er im Grunde nur besagt, dass der Server eine Anfrage nicht bearbeiten kann, weil er völlig nicht verfügbar ist. Die Gründe für diese Nichtverfügbarkeit sind vielfältig, umfassen aber typischerweise einen überladenen Server oder einen Server, der derzeit gewartet wird. Wenn 503 Codes generiert werden, sollten Entwickler Statusseiten erstellen, die den spezifischen Grund erklären, warum der Dienst nicht verfügbar ist, oder zumindest eine generische Seite, die Routen für Support oder Status-Tracking vorschlägt.

504 Gateway Timeout

Der 504-Code zeigt an, dass ein Server als Gateway fungiert, aber keine Antwort in angemessener Zeit für die Benutzeranfrage generieren kann.