HTTP-Statuscodes
HTTP-Statuscodes geben an, ob eine bestimmte HTTP-Anfrage erfolgreich abgeschlossen wurde. Antworten werden in fünf Klassen gruppiert:
- Informatorische Antworten (
100
–199
) - Erfolgreiche Antworten (
200
–299
) - Umleitungsnachrichten (
300
–399
) - Client-Fehlerantworten (
400
–499
) - Server-Fehlerantworten (
500
–599
)
Die unten aufgeführten Statuscodes sind definiert durch RFC 9110.
Hinweis: Wenn Sie eine Antwort erhalten, die hier nicht aufgeführt ist, handelt es sich um eine nicht standardmäßige Antwort, die möglicherweise serverseitig angepasst ist.
Informatorische Antworten
100 Continue
-
Diese vorläufige Antwort zeigt an, dass der Client die Anfrage fortsetzen oder die Antwort ignorieren sollte, falls die Anfrage bereits abgeschlossen ist.
101 Switching Protocols
-
Dieser Code wird als Antwort auf einen
Upgrade
-Anfrage-Header vom Client gesendet und gibt an, zu welchem Protokoll der Server wechselt. 102 Processing
Veraltet-
Dieser Code wurde in WebDAV-Kontexten verwendet, um anzuzeigen, dass eine Anfrage vom Server empfangen wurde, aber zum Zeitpunkt der Antwort keine Statusinformation verfügbar war.
103 Early Hints
-
Dieser Statuscode ist hauptsächlich dazu gedacht, mit dem Header
Link
verwendet zu werden, sodass der Benutzeragent mit dem Vorab-Laden von Ressourcen beginnen kann, während der Server eine Antwort vorbereitet oder preconnect zu einer Quelle herstellt, von der die Seite Ressourcen benötigt.
Erfolgreiche Antworten
200 OK
-
Die Anfrage war erfolgreich. Das Ergebnis und die Bedeutung von "Erfolg" hängt von der HTTP-Methode ab:
GET
: Die Ressource wurde abgerufen und im Nachrichtenkörper übermittelt.HEAD
: Repräsentative Header sind in der Antwort enthalten, jedoch kein Nachrichtenkörper.PUT
oderPOST
: Die Ressource, die das Ergebnis der Aktion beschreibt, wird im Nachrichtenkörper übermittelt.TRACE
: Der Nachrichtenkörper enthält die Anfrage, wie sie vom Server empfangen wurde.
201 Created
-
Die Anfrage war erfolgreich und eine neue Ressource wurde als Ergebnis erstellt. Dies ist typischerweise die Antwort nach
POST
-Anfragen oder einigenPUT
-Anfragen. 202 Accepted
-
Die Anfrage wurde empfangen, aber noch nicht umgesetzt. Sie ist unverbindlich, da es im HTTP keine Möglichkeit gibt, später eine asynchrone Antwort zu senden, die das Ergebnis der Anfrage anzeigt. Sie ist für Fälle gedacht, in denen ein anderer Prozess oder Server die Anfrage bearbeitet oder für Batch-Verarbeitung.
-
Dieser Antwortcode bedeutet, dass die zurückgegebenen Metadaten nicht genau dieselben sind wie vom Ursprungsserver verfügbar, sondern von einer lokalen oder einer Drittpartei-Kopie stammen. Dies wird hauptsächlich für Spiegelungen oder Backups einer anderen Ressource verwendet. Abgesehen von diesem spezifischen Fall wird die Antwort
200 OK
gegenüber diesem Status bevorzugt. 204 No Content
-
Es gibt keinen Inhalt für diese Anfrage zu senden, aber die Header sind nützlich. Der Benutzeragent kann seine zwischengespeicherten Header für diese Ressource mit den neuen aktualisieren.
205 Reset Content
-
Fordert den Benutzeragenten auf, das Dokument zurückzusetzen, das diese Anfrage gesendet hat.
206 Partial Content
-
Dieser Antwortcode wird als Antwort auf eine Bereichsanfrage verwendet, wenn der Client einen Teil oder Teile einer Ressource angefordert hat.
207 Multi-Status
(WebDAV)-
Übermittelt Informationen über mehrere Ressourcen für Situationen, in denen mehrere Statuscodes angemessen sein könnten.
208 Already Reported
(WebDAV)-
Wird innerhalb eines
<dav:propstat>
-Antwort-Elements verwendet, um die wiederholte Auflistung der internen Mitglieder mehrfacher Bindungen derselben Sammlung zu vermeiden. 226 IM Used
(HTTP Delta-Encoding)-
Der Server hat eine
GET
-Anfrage für die Ressource erfüllt, und die Antwort ist eine Darstellung des Ergebnisses einer oder mehrerer Instanz-Manipulationen, die auf die aktuelle Instanz angewendet werden.
Umleitungsnachrichten
300 Multiple Choices
-
Bei der benutzergetriebenen Inhaltsaushandlung hat die Anfrage mehr als eine mögliche Antwort, und der Benutzeragent oder der Benutzer sollte eine davon auswählen. Es gibt keine standardisierte Möglichkeit für Clients, automatisch eine der Antworten auszuwählen, daher wird dies selten verwendet.
301 Moved Permanently
-
Die URL der angeforderten Ressource wurde dauerhaft geändert. Die neue URL wird in der Antwort angegeben.
302 Found
-
Dieser Antwortcode bedeutet, dass die URI der angeforderten Ressource vorübergehend geändert wurde. Weitere Änderungen an der URI könnten in der Zukunft vorgenommen werden, daher sollte die gleiche URI von der Anfrage in zukünftigen Anfragen verwendet werden.
303 See Other
-
Der Server sendete diese Antwort, um den Client anzuweisen, die angeforderte Ressource unter einer anderen URI mit einer
GET
-Anfrage abzurufen. 304 Not Modified
-
Dies wird zu Caching-Zwecken verwendet. Es teilt dem Client mit, dass die Antwort nicht modifiziert wurde, sodass der Client die gleiche zwischengespeicherte Version der Antwort weiterhin verwenden kann.
305 Use Proxy
Veraltet-
In einer früheren Version der HTTP-Spezifikation definiert, um anzuzeigen, dass eine angeforderte Antwort über einen Proxy zugegriffen werden muss. Sie wurde aus Sicherheitsgründen bezüglich der in-band-Konfiguration eines Proxys veraltet.
306 unused
-
Dieser Antwortcode wird nicht mehr verwendet, ist aber reserviert. Er wurde in einer früheren Version der HTTP/1.1-Spezifikation verwendet.
307 Temporary Redirect
-
Der Server sendet diese Antwort, um den Client anzuweisen, die angeforderte Ressource an einer anderen URI mit der gleichen Methode abzurufen, die in der vorherigen Anfrage verwendet wurde. Dies hat die gleichen Semantiken wie der
302 Found
-Antwortcode, mit der Ausnahme, dass der Benutzeragent nicht die verwendete HTTP-Methode ändern darf: Wenn einPOST
in der ersten Anfrage verwendet wurde, muss einPOST
in der umgeleiteten Anfrage verwendet werden. 308 Permanent Redirect
-
Dies bedeutet, dass die Ressource nun dauerhaft an einer anderen URI lokalisiert ist, die durch den
Location
-Antwort-Header spezifiziert ist. Dies hat die gleichen Semantiken wie der301 Moved Permanently
HTTP-Antwortcode, mit der Ausnahme, dass der Benutzeragent nicht die verwendete HTTP-Methode ändern darf: Wenn einPOST
in der ersten Anfrage verwendet wurde, muss einPOST
in der zweiten Anfrage verwendet werden.
Client-Fehlerantworten
400 Bad Request
-
Der Server kann oder will die Anfrage nicht verarbeiten, weil etwas als Client-Fehler wahrgenommen wird (z.B. fehlerhafte Anfrage-Syntax, ungültige Anfrage-Nachricht-Rahmen, oder irreführendes Anfragerouting).
-
Obwohl der HTTP-Standard "unauthorized" (nicht autorisiert) spezifiziert, bedeutet diese Antwort semantisch "unauthenticated" (nicht authentifiziert). Das heißt, der Client muss sich authentifizieren, um die angeforderte Antwort zu erhalten.
402 Payment Required
-
Der ursprüngliche Zweck dieses Codes war für digitale Zahlungssysteme, jedoch wird dieser Statuscode selten verwendet und es existiert keine standardmäßige Konvention.
403 Forbidden
-
Der Client hat keine Zugriffsrechte auf den Inhalt, das heißt, er ist nicht autorisiert, daher verweigert der Server die angeforderte Ressource. Anders als bei
401 Unauthorized
ist die Identität des Clients dem Server bekannt. 404 Not Found
-
Der Server kann die angeforderte Ressource nicht finden. Im Browser bedeutet dies, dass die URL nicht erkannt wird. In einer API kann dies auch bedeuten, dass der Endpunkt gültig, aber die Ressource selbst nicht existiert. Server können als Sicherheit alternativ zu
403 Forbidden
diese Antwort senden, um die Existenz einer Ressource vor einem nicht autorisierten Client zu verbergen. Dieser Antwortcode ist wahrscheinlich der bekannteste aufgrund seines häufigen Auftretens im Web. 405 Method Not Allowed
-
Die Anfragemethode ist dem Server bekannt, wird aber von der Zielressource nicht unterstützt. Zum Beispiel kann eine API
DELETE
auf einer Ressource nicht erlauben oder die MethodeTRACE
insgesamt verbieten. 406 Not Acceptable
-
Diese Antwort wird gesendet, wenn der Webserver nach Durchführung der serverseitigen Inhaltsaushandlung keinen Inhalt findet, der den Kriterien des Benutzeragents entspricht.
407 Proxy Authentication Required
-
Dies ist ähnlich wie
401 Unauthorized
, aber die Authentifizierung muss von einem Proxy durchgeführt werden. 408 Request Timeout
-
Diese Antwort wird über eine inaktive Verbindung von einigen Servern gesendet, selbst ohne vorherige Anfrage vom Client. Es bedeutet, dass der Server diese ungenutzte Verbindung abschalten möchte. Diese Antwort wird häufiger genutzt, seitdem einige Browser HTTP-Vorverbindungsmechanismen zur Beschleunigung des Surfens verwenden. Einige Server mögen eine Verbindung ohne das Senden dieser Nachricht schließen.
409 Conflict
-
Diese Antwort wird gesendet, wenn eine Anfrage mit dem aktuellen Zustand des Servers in Konflikt steht. In WebDAV-Fernwebautoren sind
409
-Antworten Fehler, die an den Client gesendet werden, damit ein Benutzer möglicherweise einen Konflikt lösen und die Anfrage erneut senden kann. 410 Gone
-
Diese Antwort wird gesendet, wenn der angeforderte Inhalt dauerhaft vom Server gelöscht wurde, ohne Adresse für Weiterleitungen. Clients sollten ihre Caches und Links zur Ressource entfernen. Die HTTP-Spezifikation sieht vor, dass dieser Statuscode für "zeitlich begrenzte, Werbedienstleistungen" verwendet wird. APIs sollten sich nicht verpflichtet fühlen, Ressourcen, die gelöscht wurden, mit diesem Statuscode anzuzeigen.
411 Length Required
-
Der Server hat die Anfrage abgelehnt, weil das
Content-Length
Header-Feld nicht definiert ist und der Server dies erfordert. 412 Precondition Failed
-
In bedingten Anfragen hat der Client Bedingungen in seinen Headern angegeben, die der Server nicht erfüllt.
413 Content Too Large
-
Der Anfragetext ist größer als die vom Server definierten Grenzen. Der Server könnte die Verbindung schließen oder ein
Retry-After
-Header-Feld zurückgeben. 414 URI Too Long
-
Die vom Client angeforderte URI ist länger, als der Server interpretieren kann.
415 Unsupported Media Type
-
Das Medienformat der angeforderten Daten wird vom Server nicht unterstützt, daher lehnt der Server die Anfrage ab.
416 Range Not Satisfiable
-
Die durch den
Range
-Header-Feld in der Anfrage angegebenen Bereiche können nicht erfüllt werden. Es ist möglich, dass der Bereich außerhalb der Größe der Zielressource liegt. 417 Expectation Failed
-
Dieser Antwortcode bedeutet, dass die durch das
Expect
-Anfrage-Header-Feld angezeigten Erwartungen vom Server nicht erfüllt werden können. 418 I'm a teapot
-
Der Server lehnt den Versuch ab, Kaffee mit einer Teekanne zu brühen.
421 Misdirected Request
-
Die Anfrage wurde an einen Server gerichtet, der nicht in der Lage ist, eine Antwort zu produzieren. Dies kann von einem Server gesendet werden, der nicht konfiguriert ist, Antworten für die Kombination aus Schema und Autorität zu produzieren, die in der Anforderungs-URI enthalten sind.
422 Unprocessable Content
(WebDAV)-
Die Anfrage war wohlgeformt, konnte aber aufgrund semantischer Fehler nicht befolgt werden.
423 Locked
(WebDAV)-
Die Ressource, auf die zugegriffen wird, ist gesperrt.
424 Failed Dependency
(WebDAV)-
Die Anfrage ist aufgrund des Fehlschlags einer vorherigen Anfrage fehlgeschlagen.
425 Too Early
Experimentell-
Gibt an, dass der Server nicht bereit ist, das Risiko einzugehen, eine Anfrage zu verarbeiten, die möglicherweise erneut abgespielt wird.
426 Upgrade Required
-
Der Server lehnt es ab, die Anfrage mit dem aktuellen Protokoll durchzuführen, könnte dies aber nach einer Protokollaktualisierung des Clients tun. Der Server sendet in einer 426-Antwort einen
Upgrade
-Header, um das erforderliche Protokoll(e) anzugeben. 428 Precondition Required
-
Der Ursprungsserver verlangt, dass die Anfrage bedingt ist. Diese Antwort soll das 'verlorene Aktualisierungs'-Problem verhindern, bei dem ein Client den Zustand einer Ressource
GET
t, sie modifiziert und sie mitPUT
an den Server zurücksendet, während ein Dritter den Zustand auf dem Server geändert hat, was zu einem Konflikt führt. 429 Too Many Requests
-
Der Benutzer hat zu viele Anfragen in einem bestimmten Zeitraum gesendet (Ratenbegrenzung).
431 Request Header Fields Too Large
-
Der Server ist nicht bereit, die Anfrage zu verarbeiten, weil seine Header-Felder zu groß sind. Die Anfrage kann nach Reduzierung der Größe der Anfragen-Header-Felder erneut eingereicht werden.
-
Der Benutzeragent hat eine Ressource angefordert, die aus rechtlichen Gründen nicht bereitgestellt werden kann, wie etwa eine von einer Regierung zensierte Webseite.
Server-Fehlerantworten
500 Internal Server Error
-
Der Server hat eine Situation erlebt, die er nicht handhaben kann. Dieser Fehler ist allgemein und zeigt an, dass der Server keinen passenderen
5XX
-Statuscode finden kann, mit dem er antworten könnte. 501 Not Implemented
-
Die Anfragemethode wird vom Server nicht unterstützt und kann nicht bearbeitet werden. Die einzigen Methoden, die Server unterstützen müssen (und daher diesen Code nicht zurückgeben dürfen), sind
GET
undHEAD
. 502 Bad Gateway
-
Diese Fehlerantwort bedeutet, dass der Server, während er als Gateway arbeitet, eine ungültige Antwort erhalten hat, die für die Bearbeitung der Anfrage benötigt wird.
-
Der Server ist nicht bereit, die Anfrage zu bearbeiten. Häufige Ursachen sind ein für Wartung heruntergefahrener oder überlasteter Server. Beachten Sie, dass mit dieser Antwort eine benutzerfreundliche Seite gesendet werden sollte, die das Problem erklärt. Diese Antwort sollte für temporäre Bedingungen verwendet werden und der
Retry-After
-HTTP-Header sollte möglichst die geschätzte Zeit vor der Wiederherstellung des Dienstes enthalten. Der Webmaster muss auch die mit dieser Antwort gesendeten Cache-bezogenen Header beachten, da diese temporären Zustandsantworten in der Regel nicht zwischengespeichert werden sollten. 504 Gateway Timeout
-
Diese Fehlerantwort wird gegeben, wenn der Server als Gateway fungiert und keine Antwort rechtzeitig erhält.
505 HTTP Version Not Supported
-
Die in der Anfrage verwendete HTTP-Version wird vom Server nicht unterstützt.
506 Variant Also Negotiates
-
Der Server hat einen internen Konfigurationsfehler: während der Inhaltsaushandlung ist die gewählte Variante so konfiguriert, dass sie selbst an der Inhaltsaushandlung teilnimmt, was zu zirkulären Referenzen bei der Erstellung von Antworten führt.
507 Insufficient Storage
(WebDAV)-
Die Methode konnte auf der Ressource nicht ausgeführt werden, da der Server nicht in der Lage ist, die zur erfolgreichen Bearbeitung der Anfrage erforderliche Repräsentation zu speichern.
508 Loop Detected
(WebDAV)-
Der Server hat eine Endlosschleife bei der Verarbeitung der Anfrage entdeckt.
510 Not Extended
-
Die Client-Anfrage deklariert eine HTTP-Erweiterung (RFC 2774), die zur Verarbeitung der Anfrage verwendet werden soll, aber die Erweiterung wird nicht unterstützt.
511 Network Authentication Required
-
Gibt an, dass der Client sich authentifizieren muss, um Netzwerkzugriff zu erhalten.