HTTP-Statuscodes

Was ist eine HTTP-Statuscode-Referenz?#

Jede HTTP-Antwort trägt einen dreistelligen Statuscode, der dem Client in einer einzigen Zahl mitteilt, was mit seiner Anfrage passiert ist. Die Ziffern sind nicht zufällig: Die erste Ziffer nennt eine Familie — 1xx bedeutet „Moment, ich sende Informationen“, 2xx bedeutet „Hier, es hat geklappt“, 3xx bedeutet „Schau woanders“, 4xx bedeutet „Du, der Client, hast etwas falsch gemacht“ und 5xx bedeutet „Ich, der Server, habe etwas falsch gemacht“. Merken Sie sich diese fünf Familien und Sie können jeden HTTP-Austausch auf einen Blick lesen — sei es eine Browser-Anfrage, ein curl, den Sie ausgeführt haben, oder ein Fehler in Ihren Anwendungs-Logs.

Das Problem ist, dass über sechzig Codes aktiv verwendet werden und die Unterschiede zwischen Nachbarn oft subtil sind: 401 versus 403, 302 versus 307, 422 versus 400. Diese Seite ist eine durchsuchbare Referenz für alle — der Code, seine IANA-Phrasenbegründung, seine Familie und eine schlichte Erklärung. Tippen Sie eine Zahl oder ein Wort und die Tabelle verengt sich sofort.

Verwendung#

1. Stöbern oder suchen. Die Tabelle listet jeden Code, gruppiert nach Familie (1xx bis 5xx). Verwenden Sie das Feld Code oder Name suchen… oben zum Filtern.
2. Suchen Sie so, wie Sie denken. Der Filter ist intentionsbewusst:
   • Tippen Sie eine Zahl wie 30 oder 418 und er passt per Präfix auf Codes — 30 bringt die gesamte 3xx-Umleitungsfamilie hervor.
   • Tippen Sie ein Wort wie redirect, timeout oder teapot und er durchsucht die Phrasenbegründung und die Beschreibung, groß-/kleinschreibungsunabhängig.
3. Lesen Sie die Zeile. Jede Zeile zeigt Code (die Zahl), Grund (die Standardphrase wie „Not Found“), Kategorie (das lokalisierte Familien-Label) und Beschreibung (eine kurze Erklärung, wann dieser Code zurückgegeben wird). Die Statusleiste unter der Tabelle meldet, wie viele Zeilen passten.

Hauptfunktionen#

• Der volle IANA-Satz plus De-facto-Codes. Deckt jeden Code ab, den das Web tatsächlich zurückgibt, von 100 Continue bis 511 Network Authentication Required, inklusive der WebDAV-spezifischen Einträge 207/208/226, des Scherz-Codes 418 I'm a Teapot und des gesetzlich vorgeschriebenen 451.
• Präfix-bewusste Zahlsuche. 4 einzutippen spuckt keine zufällige Teilmenge aus — sie liefert jeden 4xx-Client-Fehler in Reihenfolge, was genau der Weg ist, eine Familie zu erkunden, an die Sie sich nicht erinnern.
• Wortsuche über Grund und Beschreibung. „rate“ findet 429 Too Many Requests; „range“ findet 416 Range Not Satisfiable; „auth“ bringt sowohl 401 als auch 407 hervor.
• Phrasenbegründungen sind universell. Die Phrasen („Not Found“, „Gateway Timeout“) sind technische Bezeichner, keine Übersetzungen — sie entsprechen dem, was Server tatsächlich on the wire senden, sodass Sie sie direkt in Dokumentation oder einen Issue-Tracker einfügen können.
• Läuft vollständig in Ihrem Browser. Der Datensatz wird mit der Seite ausgeliefert; das Filtern passiert lokal ohne Netzwerkanfrage.

Ausführliches Beispiel#

Drei Codes, über die fast jeder Entwickler mindestens einmal stolpert, sind das Client-Fehler-Trio 401, 403 und 404. Suchen Sie nach den Ziffern 40 und Sie erhalten alle in einer Ansicht, Seite an Seite:

• 401 Unauthorized — „Die Authentifizierung ist erforderlich und fehlgeschlagen oder wurde nicht bereitgestellt.“ Der Server weiß nicht, wer Sie sind. Lösung: Anmeldedaten senden (einen Login-Token, einen API-Schlüssel).
• 403 Forbidden — „Die Anfrage war gültig, aber der Server verweigert die Aktion (unzureichende Rechte).“ Der Server weiß genau, wer Sie sind, und Sie dürfen trotzdem nicht darauf zugreifen. Lösung: Erlaubnis einholen, nicht ein weiteres Passwort.
• 404 Not Found — „Die angeforderte Ressource konnte nicht gefunden werden.“ Die URL selbst ist falsch oder die Ressource ist weg. Lösung: Den Pfad korrigieren.

Die nützlichste Unterscheidung ist 401 versus 403: „Ich kenne dich nicht“ (einloggen) versus „Ich kenne dich, und nein“ (Zugriff erbeten). Erneutes Authentifizieren wird nie einen 403 beheben, und ein Herumbasteln an der URL wird nie einen 401 beheben.

Eine zweite praktische Nachschlage ist die Umleitungsfamilie. Suchen Sie 30 und Sie sehen, dass 301 und 302 historisch Clients erlaubten, die Methode bei der nächsten Anfrage zu ändern (ein POST konnte zu einem GET degradieren), wohingegen 307 und 308 genau eingeführt wurden, um die ursprüngliche Methode beizubehalten — weshalb moderne APIs, die Formular-Übermittlungen umleiten, Sie auf 307/308 statt auf 301/302 verweisen.

FAQ#

Was bedeutet die erste Ziffer eines Statuscodes?#

Sie nennt die Familie. 1xx ist informativ (der Server sagt „warte, es kommt mehr“), 2xx ist Erfolg, 3xx ist Umleitung (woanders schauen), 4xx ist ein Client-Fehler (Ihre Anfrage war falsch) und 5xx ist ein Server-Fehler (die Anfrage war in Ordnung, aber der Server ist gescheitert). Die restlichen zwei Ziffern identifizieren den spezifischen Code innerhalb dieser Familie.

Ist 418 ein echter Statuscode?#

Er stammt aus einem Aprilscherz-RFC über eine Teekanne, die den Kaffeezubereiten verweigert, also ist er nicht für den produktiven Einsatz gedacht. Allerdings geben manche Dienste tatsächlich 418 als verspielte „Du hast mir etwas Unsinniges geschickt“-Antwort zurück, und es ist harmlos, ihn zu erkennen. Diese Referenz listet ihn, weil Sie ihm in freier Wildbahn begegnen werden.

Warum sind einige Codes als WebDAV markiert?#

Codes wie 207 Multi-Status, 423 Locked und 507 Insufficient Storage wurden für WebDAV definiert, eine HTTP-Erweiterung für kollaborative Dateibearbeitung. Sie sind auf gewöhnlichen Web-APIs selten, tauchen aber in Systemen auf, die eine dateisystemartige Schnittstelle freigeben, daher notieren die Beschreibungen den WebDAV-Ursprung, damit der Kontext Sinn ergibt.

Woher kommen die Phrasenbegründungen?#

Es sind die englischen Standard-Phrasenbegründungen, die bei der IANA registriert sind — dieselben Zeichenketten, die Server nach dem Code in der Statuszeile anhängen (zum Beispiel HTTP/1.1 404 Not Found). Es sind technische Bezeichner, daher werden sie unverändert gezeigt statt übersetzt; der lokalisierte Teil der Seite sind die Spaltenüberschriften, die Kategorie-Labels und dieser erklärende Text.