HTTP-Statuscodes
Nur lokal — es wird nichts hochgeladen, außer Sie speichern oder teilen es.
Jeder HTTP-Statuscode, was er bedeutet und wann man ihn sendet — mit dem RFC, der ihn definiert.
- Tippen Sie den Code, etwa 404, oder ein Wort wie „Weiterleitung“ in das Suchfeld.
- Lesen Sie, was der Code bedeutet, wann man ihn sendet und welcher RFC ihn definiert.
- Wählen Sie eine Klasse wie 4xx, oder leeren Sie das Feld, um alle Codes nach Klasse geordnet zu sehen.
1xx · Informativ
Continue
Der Server hat die Header der Anfrage erhalten, und der Client soll nun den Body senden.
Wann man ihn verwendet: Antwortet auf eine Anfrage mit Expect: 100-continue, damit ein Client prüfen kann, ob ein großer Upload angenommen wird, bevor er ihn sendet.
Definiert in RFC 9110 §15.2.1
Switching Protocols
Der Server ist einverstanden, auf das Protokoll zu wechseln, das der Client in seinem Upgrade-Header verlangt hat.
Wann man ihn verwendet: Die Antwort eines Servers, wenn eine Verbindung auf WebSocket umgestellt wird — dort begegnet er den meisten.
Definiert in RFC 9110 §15.2.2
Processing
Eine Zwischenantwort von WebDAV, die sagt, dass der Server die Anfrage hat und noch daran arbeitet.
Wann man ihn verwendet: Hielt eine Verbindung bei langen WebDAV-Operationen davon ab, in ein Timeout zu laufen. Spätere WebDAV-Spezifikationen haben ihn gestrichen, und er wird heute selten gesendet.
Definiert in RFC 2518
Early Hints
Eine Zwischenantwort, die einige Header, meist Link-Header, schickt, bevor die endgültige Antwort fertig ist.
Wann man ihn verwendet: Lässt einen Browser schon Stylesheets und Skripte vorladen, während der Server die Seite noch aufbaut.
Definiert in RFC 8297
2xx · Erfolgreich
OK
Die Anfrage war erfolgreich. Was der Body enthält, hängt von der Methode ab: die Ressource bei GET, das Ergebnis der Aktion bei POST.
Wann man ihn verwendet: Die Standardantwort auf eine Anfrage, die funktioniert hat. Wenn etwas Neues angelegt wurde, sagt 201 mehr.
Definiert in RFC 9110 §15.3.1
Created
Die Anfrage war erfolgreich und hat eine oder mehrere neue Ressourcen angelegt.
Wann man ihn verwendet: Die Antwort auf ein POST oder PUT, das etwas angelegt hat, mit einem Location-Header, der auf die neue Ressource zeigt.
Definiert in RFC 9110 §15.3.2
Accepted
Die Anfrage wurde zur Verarbeitung angenommen, aber die Verarbeitung ist noch nicht fertig und kann noch scheitern.
Wann man ihn verwendet: Für Arbeit, die im Hintergrund läuft — ein Job in der Warteschlange, ein Massenimport —, idealerweise mit einem Link, unter dem der Client den Fortschritt prüfen kann.
Definiert in RFC 9110 §15.3.3
Non-Authoritative Information
Die Anfrage war erfolgreich, aber ein Proxy dazwischen hat die Antwort verändert, die er vom Ursprungsserver bekam.
Wann man ihn verwendet: Von umwandelnden Proxys gesendet, um zu sagen, dass der Inhalt nicht genau dem entspricht, was der Ursprung geschickt hat. Selten zu sehen.
Definiert in RFC 9110 §15.3.4
No Content
Die Anfrage war erfolgreich, und die Antwort hat absichtlich keinen Body.
Wann man ihn verwendet: Eine häufige Antwort auf ein DELETE oder auf ein PUT, bei dem der Client keine Kopie zurück braucht.
Definiert in RFC 9110 §15.3.5
Reset Content
Die Anfrage war erfolgreich, und der Client soll die Ansicht zurücksetzen, die sie gesendet hat, etwa ein Formular leeren.
Wann man ihn verwendet: Gedacht für Eingabeoberflächen, die das Formular für den nächsten Eintrag leeren wollen. Browser machen in der Praxis wenig damit.
Definiert in RFC 9110 §15.3.6
Partial Content
Der Server sendet nur den Teil der Ressource, den der Client in einem Range-Header verlangt hat.
Wann man ihn verwendet: So holen Video-Spulen, fortgesetzte Downloads und Download-Manager eine Datei in Stücken.
Definiert in RFC 9110 §15.3.7
Multi-Status
Eine WebDAV-Antwort, deren XML-Body für jede von mehreren Ressourcen einen eigenen Status enthält.
Wann man ihn verwendet: Für eine einzelne Anfrage, die auf viele Elemente gewirkt hat, von denen manche gelungen und andere gescheitert sein können.
Definiert in RFC 4918
Already Reported
Wird in einer WebDAV-207-Antwort verwendet, um zu sagen, dass die Mitglieder einer Ressource weiter oben in derselben Antwort schon aufgeführt wurden.
Wann man ihn verwendet: Verhindert, dass dasselbe Element wiederholt wird, wenn eine Sammlung über mehr als ein Binding erreichbar ist.
Definiert in RFC 5842
IM Used
Der Server hat ein GET erfüllt, und die Antwort ist das Ergebnis von Instanz-Manipulationen, etwa einem Delta, angewendet auf die aktuelle Ressource.
Wann man ihn verwendet: Teil des HTTP-Delta-Encodings (RFC 3229), bei dem ein Client nur das verlangt, was sich seit seiner Kopie geändert hat. Selten umgesetzt.
Definiert in RFC 3229
3xx · Weiterleitung
Multiple Choices
Die Ressource hat mehrere Darstellungen, und der Client oder der Nutzer soll eine wählen.
Wann man ihn verwendet: Selten verwendet, weil es keinen Standardweg gibt, automatisch zu wählen; Server wählen meist selbst eine und senden sie.
Definiert in RFC 9110 §15.4.1
Moved Permanently
Die Ressource hat eine neue dauerhafte Adresse, angegeben im Location-Header, und Links sollten darauf umgestellt werden.
Wann man ihn verwendet: Für eine Seite, die endgültig umgezogen ist. Suchmaschinen geben ihr Ranking an die neue Adresse weiter. Ein Client darf beim Folgen aus einem POST ein GET machen, nehmen Sie also 308, wo die Methode zählt.
Definiert in RFC 9110 §15.4.2
Found
Auch bekannt als: Moved Temporarily
Die Ressource liegt vorübergehend unter einer anderen Adresse, angegeben im Location-Header; die ursprüngliche Adresse bleibt die richtige.
Wann man ihn verwendet: Für einen kurzfristigen Umzug, etwa um Besucher auf eine Anmeldeseite zu schicken. Clients dürfen beim Folgen POST in GET ändern; 307 verbietet das.
Definiert in RFC 9110 §15.4.3
See Other
Die Antwort liegt unter einer anderen Adresse, und der Client soll sie mit einem GET abrufen.
Wann man ihn verwendet: Die klassische Antwort nach einem Formular-POST (Post/Redirect/Get), damit ein Neuladen der Ergebnisseite das Formular nicht erneut absendet.
Definiert in RFC 9110 §15.4.4
Not Modified
Die zwischengespeicherte Kopie des Clients ist noch aktuell, also sendet der Server keinen Body.
Wann man ihn verwendet: Die Antwort auf ein bedingtes GET mit If-None-Match oder If-Modified-Since, wenn sich nichts geändert hat. Kein Fehler: So funktioniert Caching.
Definiert in RFC 9110 §15.4.5
Use Proxy
Nicht in GebrauchWies den Client einst an, die Anfrage über den im Location-Header genannten Proxy zu wiederholen.
Wann man ihn verwendet: Aus Sicherheitsgründen veraltet, weil eine Antwort damit Datenverkehr über einen Proxy ihrer Wahl umleiten konnte. Nicht senden.
Definiert in RFC 9110 §15.4.6
(Unused)
Nicht in GebrauchReserviert. Ein früherer Entwurf definierte ihn als Switch Proxy, verwendet wurde er nie.
Wann man ihn verwendet: Nie senden. Die Zahl bleibt reserviert, damit sie nicht neu vergeben wird.
Definiert in RFC 9110 §15.4.7
Temporary Redirect
Die Ressource liegt vorübergehend unter der Adresse im Location-Header, und der Client muss die Anfrage dort mit derselben Methode und demselben Body wiederholen.
Wann man ihn verwendet: Die temporäre Weiterleitung, wenn ein POST ein POST bleiben muss. HSTS-Upgrades von http auf https erscheinen in Browsern ebenfalls als 307.
Definiert in RFC 9110 §15.4.8
Permanent Redirect
Die Ressource ist dauerhaft zur Adresse im Location-Header umgezogen, und der Client muss dieselbe Methode und denselben Body beibehalten.
Wann man ihn verwendet: Eine dauerhafte Weiterleitung für eine API oder jeden Endpunkt, der POST oder PUT annimmt, wo ein 301 die Anfrage in ein GET verwandeln könnte.
Definiert in RFC 9110 §15.4.9
4xx · Client-Fehler
Bad Request
Der Server kann die Anfrage wegen etwas nicht verarbeiten, das er als Fehler des Clients ansieht, etwa fehlerhafte Syntax.
Wann man ihn verwendet: Für eine Anfrage, die sich überhaupt nicht parsen lässt: kaputtes JSON, ein ungültiger Header, ein fehlender Pflichtparameter.
Definiert in RFC 9110 §15.5.1
Unauthorized
Der Anfrage fehlen gültige Zugangsdaten für die Ressource. Trotz des Namens geht es um Authentifizierung, nicht um Berechtigung.
Wann man ihn verwendet: Wenn der Client nicht angemeldet ist oder sein Token abgelaufen ist. Die Antwort muss einen WWW-Authenticate-Header enthalten, der sagt, wie man sich authentifiziert.
Definiert in RFC 9110 §15.5.2
Payment Required
Für künftige Verwendung reserviert. Die Spezifikation hat nie definiert, was er tun soll.
Wann man ihn verwendet: Manche APIs senden ihn, wenn ein Abonnement abgelaufen oder eine Zahlung gescheitert ist, aber dahinter steht kein Standardverhalten.
Definiert in RFC 9110 §15.5.3
Forbidden
Der Server hat die Anfrage verstanden und weigert sich, sie zu erfüllen. Dieselben Zugangsdaten erneut zu senden ändert nichts an der Antwort.
Wann man ihn verwendet: Wenn der Nutzer bekannt, aber nicht berechtigt ist: das Konto eines anderen, eine Admin-Seite, ein gesperrtes Land oder eine gesperrte IP-Adresse.
Definiert in RFC 9110 §15.5.4
Not Found
Der Server hat unter dieser Adresse nichts oder will nicht sagen, ob er etwas hat.
Wann man ihn verwendet: Die Antwort auf einen kaputten Link oder eine vertippte URL. Wird auch statt 403 verwendet, um zu verbergen, dass eine private Ressource existiert. Ist sie endgültig weg, sagt 410 das.
Definiert in RFC 9110 §15.5.5
Method Not Allowed
Die Methode ist dem Server bekannt, wird von dieser Ressource aber nicht unterstützt.
Wann man ihn verwendet: Für ein POST an eine schreibgeschützte Adresse oder ein DELETE, wo nichts gelöscht werden kann. Die Antwort muss die erlaubten Methoden in einem Allow-Header aufführen.
Definiert in RFC 9110 §15.5.6
Not Acceptable
Der Server kann keine Antwort in einem Format liefern, das der Client laut seinen Accept-Headern annimmt.
Wann man ihn verwendet: Content Negotiation ohne gemeinsamen Nenner, etwa ein Client, der nur XML annimmt, bei einer API, die nur JSON spricht. Die meisten Server senden stattdessen ihr Standardformat.
Definiert in RFC 9110 §15.5.7
Proxy Authentication Required
Wie 401, aber es ist ein Proxy zwischen Client und Server, bei dem sich der Client authentifizieren muss.
Wann man ihn verwendet: Von Firmen- und anderen authentifizierenden Proxys gesendet, mit einem Proxy-Authenticate-Header, der sagt, wie.
Definiert in RFC 9110 §15.5.8
Request Timeout
Der Server hat es aufgegeben, darauf zu warten, dass der Client seine Anfrage fertig sendet.
Wann man ihn verwendet: Auf einer untätigen Verbindung gesendet, bevor der Server sie schließt. Clients dürfen die Anfrage einfach über eine neue Verbindung wiederholen.
Definiert in RFC 9110 §15.5.9
Conflict
Die Anfrage steht im Konflikt mit dem aktuellen Zustand der Ressource.
Wann man ihn verwendet: Eine Bearbeitung auf Basis einer veralteten Version, ein schon vergebener Benutzername oder der Upload einer Datei, deren Name bereits belegt ist.
Definiert in RFC 9110 §15.5.10
Gone
Die Ressource war früher hier und wurde absichtlich entfernt, ohne Weiterleitungsadresse.
Wann man ihn verwendet: Für Inhalte, die endgültig entfernt wurden. Er sagt Suchmaschinen deutlicher als 404, dass die Seite nicht zurückkommt.
Definiert in RFC 9110 §15.5.11
Length Required
Der Server lehnt eine Anfrage ab, die einen Body, aber keinen Content-Length-Header hat.
Wann man ihn verwendet: Von Servern gesendet, die keine gechunkten Uploads unbekannter Länge annehmen.
Definiert in RFC 9110 §15.5.12
Precondition Failed
Eine Bedingung in den Headern der Anfrage, etwa If-Match oder If-Unmodified-Since, war nicht erfüllt.
Wann man ihn verwendet: Schützt vor verlorenen Änderungen: Die Ressource hat sich geändert, seit der Client sie zuletzt gelesen hat, also wird das Schreiben abgelehnt.
Definiert in RFC 9110 §15.5.13
Content Too Large
Auch bekannt als: Payload Too Large, Request Entity Too Large
Der Body der Anfrage ist größer, als der Server verarbeiten will oder kann. RFC 9110 hat ihn von Payload Too Large umbenannt.
Wann man ihn verwendet: Ein Upload über der Größengrenze. Ist die Grenze nur vorübergehend, sagt ein Retry-After-Header, wann man es erneut versuchen kann.
Definiert in RFC 9110 §15.5.14
URI Too Long
Auch bekannt als: Request-URI Too Long
Die URI der Anfrage ist länger, als der Server lesen will.
Wann man ihn verwendet: Meist ein als GET gesendetes Formular mit riesigem Query-String oder eine Weiterleitungsschleife, die die URL immer weiter verlängert hat. Senden Sie die Daten stattdessen als POST-Body.
Definiert in RFC 9110 §15.5.15
Unsupported Media Type
Der Server lehnt die Anfrage ab, weil der Body in einem Format vorliegt, das er nicht unterstützt.
Wann man ihn verwendet: Ein falscher oder fehlender Content-Type, etwa Formulardaten an einem Endpunkt, der nur application/json annimmt.
Definiert in RFC 9110 §15.5.16
Range Not Satisfiable
Auch bekannt als: Requested Range Not Satisfiable
Keiner der Bereiche im Range-Header der Anfrage überschneidet sich mit der Ressource.
Wann man ihn verwendet: Bytes jenseits des Dateiendes anfordern, oft ein fortgesetzter Download einer Datei, die inzwischen kleiner geworden ist.
Definiert in RFC 9110 §15.5.17
Expectation Failed
Der Server kann die Anforderung im Expect-Header der Anfrage nicht erfüllen.
Wann man ihn verwendet: Meist zu sehen, wenn ein Proxy oder Server Expect: 100-continue nicht unterstützt. Ein neuer Versuch ohne den Header funktioniert in der Regel.
Definiert in RFC 9110 §15.5.18
(Unused)
Nicht in GebrauchAuch bekannt als: I'm a teapot
Der Aprilscherz-Code aus RFC 2324: eine Teekanne, die sich weigert, Kaffee zu kochen. RFC 9110 reserviert die Zahl, damit sie nie eine echte Bedeutung bekommt.
Wann man ihn verwendet: Nicht für den Produktivbetrieb. Manche Websites senden ihn als Easter Egg oder um Bots abzuweisen, aber man kann nicht erwarten, dass Clients ihn verstehen.
Definiert in RFC 9110 §15.5.19
Misdirected Request
Die Anfrage hat einen Server erreicht, der für den darin genannten Host keine Antwort erzeugen kann.
Wann man ihn verwendet: Passiert meist bei der Wiederverwendung von HTTP/2-Verbindungen, wenn eine Verbindung für Hostnamen geteilt wird, für die der Server nicht eingerichtet ist. Der Client sollte es über eine neue Verbindung erneut versuchen.
Definiert in RFC 9110 §15.5.20
Unprocessable Content
Auch bekannt als: Unprocessable Entity
Der Server versteht den Inhaltstyp und die Syntax ist korrekt, aber er kann nicht verarbeiten, was die Anfrage enthält. Früher Unprocessable Entity.
Wann man ihn verwendet: Die übliche Antwort auf einen Validierungsfehler in einer wohlgeformten Anfrage. Seit RFC 9110 Teil von HTTP selbst, nicht nur von WebDAV.
Definiert in RFC 9110 §15.5.21
Locked
Die WebDAV-Ressource, auf die zugegriffen wird, ist gesperrt.
Wann man ihn verwendet: Eine Datei, die ein anderer Nutzer zum Bearbeiten gesperrt hat.
Definiert in RFC 4918
Failed Dependency
Die Anfrage ist gescheitert, weil eine andere Aktion, von der sie abhing, gescheitert ist.
Wann man ihn verwendet: In einem WebDAV-Stapel die Operationen, die nicht laufen konnten, weil eine frühere in derselben Anfrage gescheitert ist.
Definiert in RFC 4918
Too Early
Der Server will nicht riskieren, eine Anfrage zu verarbeiten, die wiederholt eingespielt werden könnte.
Wann man ihn verwendet: Für Anfragen, die als TLS-1.3-Early-Data (0-RTT) gesendet wurden und die ein Angreifer wiederholen könnte. Der Client sollte es nach abgeschlossenem Handshake erneut versuchen.
Definiert in RFC 8470
Upgrade Required
Der Server lehnt die Anfrage über das aktuelle Protokoll ab, würde sie aber annehmen, nachdem der Client gewechselt hat.
Wann man ihn verwendet: Mit einem Upgrade-Header gesendet, der das nötige Protokoll nennt, zum Beispiel eine neuere Version von HTTP oder TLS.
Definiert in RFC 9110 §15.5.22
Precondition Required
Der Server verlangt, dass die Anfrage bedingt ist, mit einem Header wie If-Match.
Wann man ihn verwendet: Zwingt Clients nachzuweisen, welche Version sie ändern, damit sich zwei Bearbeitungen nicht unbemerkt gegenseitig überschreiben.
Definiert in RFC 6585
Too Many Requests
Der Client hat in einer bestimmten Zeit zu viele Anfragen gesendet.
Wann man ihn verwendet: Rate Limiting. Ein Retry-After-Header sagt, wie lange man warten soll; Clients sollten zurückstecken, statt sofort neu zu versuchen.
Definiert in RFC 6585
Request Header Fields Too Large
Der Server verarbeitet die Anfrage nicht, weil ihre Header, oder ein einzelner Header, zu groß sind.
Wann man ihn verwendet: Meist ein übergroßes Cookie oder zu viele Cookies für eine Domain. Die Cookies der Website zu löschen behebt es meist.
Definiert in RFC 6585
Unavailable For Legal Reasons
Der Server verweigert den Zugriff auf die Ressource wegen einer rechtlichen Forderung.
Wann man ihn verwendet: Inhalte, die durch einen Gerichtsbeschluss, eine behördliche Anordnung oder eine Sperre in einem Land blockiert sind. Die Zahl spielt auf den Roman Fahrenheit 451 an.
Definiert in RFC 7725
5xx · Server-Fehler
Internal Server Error
Der Server ist auf einen unerwarteten Zustand gestoßen, der ihn daran gehindert hat, die Anfrage zu erfüllen.
Wann man ihn verwendet: Der Sammelcode für einen Absturz oder eine unbehandelte Exception. Die Logs des Servers sagen, was wirklich passiert ist; der Client kann es meist nicht beheben.
Definiert in RFC 9110 §15.6.1
Not Implemented
Der Server unterstützt die Funktion nicht, die zum Erfüllen der Anfrage nötig ist.
Wann man ihn verwendet: Eine Methode, die der Server überhaupt nicht kennt. Anders als 405 bedeutet er, dass keine Ressource auf diesem Server sie unterstützt.
Definiert in RFC 9110 §15.6.2
Bad Gateway
Ein Server, der als Gateway oder Proxy arbeitet, hat vom Server dahinter eine ungültige Antwort oder gar keine bekommen.
Wann man ihn verwendet: Die Anwendung hinter nginx, einem Load Balancer oder einem CDN ist abgestürzt, startet neu oder ist nicht erreichbar.
Definiert in RFC 9110 §15.6.3
Service Unavailable
Der Server kann die Anfrage gerade nicht bearbeiten, weil er überlastet ist oder wegen Wartung nicht läuft.
Wann man ihn verwendet: Ein vorübergehender Zustand. Senden Sie einen Retry-After-Header, der sagt, wann man wiederkommen soll; Suchmaschinen behandeln einen 503 als vorübergehend und behalten die Seite.
Definiert in RFC 9110 §15.6.4
Gateway Timeout
Ein Server, der als Gateway oder Proxy arbeitet, hat vom Server dahinter nicht rechtzeitig eine Antwort bekommen.
Wann man ihn verwendet: Eine langsame Datenbankabfrage oder ein Backend, das länger braucht, als das Timeout des Proxys erlaubt.
Definiert in RFC 9110 §15.6.5
HTTP Version Not Supported
Der Server unterstützt die Hauptversion von HTTP nicht, die in der Anfrage verwendet wird.
Wann man ihn verwendet: Selten, da fast jeder Server HTTP/1.1, HTTP/2 und oft HTTP/3 spricht.
Definiert in RFC 9110 §15.6.6
Variant Also Negotiates
Ein Konfigurationsfehler des Servers bei transparenter Content Negotiation: Die gewählte Variante ist selbst zum Verhandeln eingerichtet, was eine Schleife ergäbe.
Wann man ihn verwendet: Stammt aus experimenteller Content Negotiation (RFC 2295) und ist fast nie zu sehen.
Definiert in RFC 2295
Insufficient Storage
Der Server kann nicht speichern, was er für die Anfrage speichern müsste.
Wann man ihn verwendet: Ein WebDAV-Upload oder -Kopiervorgang, wenn die Festplatte oder das Kontingent des Nutzers voll ist.
Definiert in RFC 4918
Loop Detected
Der Server hat eine WebDAV-Operation abgebrochen, weil er eine Endlosschleife gefunden hat.
Wann man ihn verwendet: Eine Anfrage mit Depth: infinity über Bindings, die aufeinander zurückverweisen.
Definiert in RFC 5842
Not Extended
Nicht in GebrauchDie Anfrage braucht weitere Erweiterungen, die der Server verlangt, bevor er sie erfüllt.
Wann man ihn verwendet: Stammt aus dem HTTP Extension Framework (RFC 2774), das inzwischen als historisch eingestuft ist, und die Registry markiert den Code als obsolet. Nicht senden.
Definiert in RFC 2774
Network Authentication Required
Der Client muss sich authentifizieren, um überhaupt Netzwerkzugang zu bekommen.
Wann man ihn verwendet: Von Captive Portals gesendet, etwa den WLAN-Anmeldeseiten in Hotels oder Flughäfen, die den Datenverkehr abfangen, bis sich der Nutzer anmeldet.
Definiert in RFC 6585
Tool speichern
HTTP-Statuscodes griffbereit halten
Nutzen Sie das Teilen-Menü Ihres Browsers und dann „Zum Home-Bildschirm“.
Einbetten
HTTP-Statuscodes auf Ihrer Website einbinden
Fügen Sie diesen Code in Ihre Seite ein. Er zeigt das Tool kostenlos, mit einem Link dorthin.
Über dieses Tool
Jeder HTTP-Statuscode aus der offiziellen IANA-Registry, von 100 Continue bis 511 Network Authentication Required, jeweils mit einer verständlichen Erklärung, was er bedeutet, wann ein Server ihn senden sollte, und einem Link zu dem Abschnitt des RFC, der ihn definiert. Tippen Sie eine Zahl ein, die erste Ziffer einer Klasse („4“ oder „4xx“) oder ein Wort wie „Weiterleitung“ oder „rate limit“, und die Liste wird beim Tippen kürzer. Die Unterschiede, auf die es ankommt, werden ausgeschrieben, statt sie dem Namen zu überlassen. 401 Unauthorized bedeutet, dass die Anfrage nicht authentifiziert war — melden Sie sich an und versuchen Sie es erneut —, während 403 Forbidden bedeutet, dass der Server die Anfrage verstanden hat und trotzdem Nein sagt. 301 und 302 erlauben einem alten Client, auf dem Weg zur neuen Adresse aus einem POST ein GET zu machen; 308 und 307 sind dieselben beiden Weiterleitungen, bei denen die Methode garantiert erhalten bleibt. 422 Unprocessable Content ist kein WebDAV-Zusatz mehr: RFC 9110 hat ihn 2022 zu einem Teil von HTTP selbst gemacht, weshalb er die übliche Antwort auf einen Validierungsfehler ist. Die Namen bleiben genau so, wie die Spezifikation sie schreibt, denn so stehen sie in der Statuszeile, in Ihren Logs und in jeder Bibliothek. Wo ein Code umbenannt wurde — 413 hieß früher Payload Too Large, 422 Unprocessable Entity —, wird auch der alte Name gezeigt und gefunden. Auch 418 I'm a teapot ist dabei, gekennzeichnet als das, was er ist: ein Aprilscherz aus RFC 2324, den RFC 9110 nun reserviert, damit niemand der Zahl eine echte Aufgabe gibt. Inoffizielle Codes wie 499 von nginx oder 520 bis 526 von Cloudflare stehen nicht in der Registry und werden nicht so aufgeführt, als ob. Alles läuft in Ihrem Browser und funktioniert offline, sobald die Seite geladen ist.
Häufige Fragen
Was ist der Unterschied zwischen 401 und 403?
401 Unauthorized bedeutet, dass die Anfrage keine gültigen Zugangsdaten hat: Der Server weiß nicht, wer Sie sind, und muss in einem WWW-Authenticate-Header angeben, wie man sich authentifiziert. Eine Anmeldung kann das beheben. 403 Forbidden bedeutet, dass der Server die Anfrage verstanden hat und sie trotzdem ablehnt: Sie mit denselben Zugangsdaten zu wiederholen hilft nicht, nur ein Konto mit der richtigen Berechtigung. Trotz seines Namens geht es bei 401 um Authentifizierung und bei 403 um Berechtigung.
Soll ich 301 oder 308 für eine dauerhafte Weiterleitung verwenden?
Für eine Webseite funktioniert beides, und 301 ist der Code, den jeder Crawler und Browser seit Jahrzehnten kennt; Suchmaschinen behandeln beide gleich. Der Unterschied ist die Methode. Bei 301 darf ein alter Client beim Folgen der Weiterleitung aus einem POST ein GET machen, während 308 zusichert, dass Methode und Body genau so bleiben, wie sie waren. Für einen API-Endpunkt, der POST oder PUT annimmt, nehmen Sie 308. Das temporäre Paar funktioniert genauso: 302 darf die Methode ändern, 307 nicht.
Was bedeutet 304 Not Modified?
Er beantwortet eine bedingte Anfrage — eine mit If-None-Match oder If-Modified-Since — und sagt, dass die Kopie, die der Client schon hat, noch aktuell ist, also wird kein Body gesendet. So spart Caching Bandbreite, und es ist kein Fehler: Viele 304er in Ihren Logs bedeuten, dass das Caching funktioniert.
Ist 422 oder 400 richtig für einen Validierungsfehler?
Nehmen Sie 400, wenn die Anfrage überhaupt nicht gelesen werden kann — kaputtes JSON, ein fehlender Pflicht-Header. Nehmen Sie 422 Unprocessable Content, wenn sie wohlgeformt ist, ihr Inhalt aber nicht verarbeitet werden kann, etwa ein E-Mail-Feld, in dem keine E-Mail-Adresse steht. 422 stammt aus WebDAV und wurde 2022 mit RFC 9110 in HTTP selbst übernommen, ist also keine Erweiterung mehr.
Was ist der Unterschied zwischen 502, 503 und 504?
Alle drei kommen meist von einem Proxy oder Load Balancer statt von Ihrer Anwendung. 502 Bad Gateway bedeutet, dass der Server dahinter eine ungültige Antwort oder gar keine geschickt hat, oft weil er abgestürzt ist. 503 Service Unavailable bedeutet, dass der Server läuft, die Anfrage aber gerade nicht annehmen kann — überlastet oder in Wartung —, idealerweise mit einem Retry-After-Header. 504 Gateway Timeout bedeutet, dass der Server hinter dem Proxy zu lange für die Antwort gebraucht hat.
Ist 418 I'm a teapot ein echter Statuscode?
Er begann als Scherz: RFC 2324, ein Aprilscherz-RFC von 1998, definierte ihn für Kaffeemaschinen, die Kaffee kochen sollen, aber Teekannen sind. Er war nie zur Umsetzung gedacht, doch so viele Frameworks haben ihn eingebaut, dass RFC 9110 die 418 nun als reserviert markiert, damit die Zahl keine echte Bedeutung bekommen kann. Ihn produktiv zu verwenden ist ein Witz, den die Clients Ihrer API verstehen müssen.
Warum fehlen 499, 509 und 520?
Es sind keine registrierten HTTP-Statuscodes. 499 protokolliert nginx, wenn der Client die Verbindung vor der Antwort geschlossen hat, 509 Bandwidth Limit Exceeded kommt von manchen Webhostern, und 520 bis 526 sind Cloudflares eigene Fehler für Probleme beim Erreichen des Ursprungsservers. Jeder davon bedeutet nur für dieses Produkt etwas, deshalb hält sich die Liste an die offizielle Registry.
Helfen Sie, dieses Tool zu verbessern
Einen Fehler gefunden, eine Änderung im Kopf, oder fehlt Ihnen ein Tool?
Sie haben einen ungesendeten Entwurf.
Danke — ist bei uns angekommen. Die Antwort finden Sie in Ihrem Postfach.Zu meinen Nachrichten