2xx · Erfolgreich
200
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
201
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
202
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
203
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
204
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
205
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
206
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
207
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
208
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
226
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
300
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
301
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
302
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
303
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
304
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
305
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
306
(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
307
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
308
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
400
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
401
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
402
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
403
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
404
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
405
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
406
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
407
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
408
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
409
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
410
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
411
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
412
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
413
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
414
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
415
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
416
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
417
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
418
(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
421
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
422
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
423
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
424
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
425
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
426
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
428
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
429
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
431
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
451
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
500
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
501
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
502
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
503
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
504
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
505
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
506
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
507
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
508
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
510
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
511
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