HTTP-Statuscode-Nachschlag

HTTP-Statuscodes offline nachschlagen

Showing 62 of 62 status codes

1xx Informational

100

Continue

The server has received the request headers and the client should proceed to send the request body.

101

Switching Protocols

The requester has asked the server to switch protocols and the server has agreed to do so.

102

Processing

The server has received and is processing the request, but no response is available yet.

103

Early Hints

Used to return some response headers before final HTTP message.

2xx Success

200

The request has succeeded. The meaning of the success depends on the HTTP method.

201

Created

The request has succeeded and a new resource has been created as a result.

202

Accepted

The request has been received but not yet acted upon. It is intended for cases where another process handles the request.

203

Non-Authoritative Information

The returned metadata is not exactly the same as is available from the origin server.

204

No Content

There is no content to send for this request, but the headers may be useful.

205

Reset Content

Tells the user agent to reset the document which sent this request.

206

Partial Content

This response code is used when the Range header is sent from the client to request only part of a resource.

207

Multi-Status

Conveys information about multiple resources, for situations where multiple status codes might be appropriate.

208

Already Reported

Used inside a DAV: propstat response element to avoid enumerating the internal members of multiple bindings.

226

IM Used

The server has fulfilled a GET request for the resource, and the response is a representation of the result.

3xx Redirection

300

Multiple Choices

The request has more than one possible response. The user agent or user should choose one of them.

301

Moved Permanently

The URL of the requested resource has been changed permanently. The new URL is given in the response.

302

Found

The URI of requested resource has been changed temporarily. Further changes in the URI might be made in the future.

303

See Other

The server sent this response to direct the client to get the requested resource at another URI with a GET request.

304

Not Modified

This is used for caching purposes. It tells the client that the response has not been modified.

305

Use Proxy

Deprecated. Was defined to indicate that a requested response must be accessed by a proxy.

307

Temporary Redirect

The server sends this response to direct the client to get the requested resource at another URI with same method.

308

Permanent Redirect

The resource is now permanently located at another URI, specified by the Location header.

4xx Client Error

400

Bad Request

The server cannot or will not process the request due to something that is perceived to be a client error.

401

Unauthorized

The client must authenticate itself to get the requested response.

402

Payment Required

Reserved for future use. Originally created for digital payment systems.

403

Forbidden

The client does not have access rights to the content; the server is refusing to give the requested resource.

404

Not Found

The server cannot find the requested resource. This can also mean the endpoint is valid but the resource does not exist.

405

Method Not Allowed

The request method is known by the server but is not supported by the target resource.

406

Not Acceptable

The server cannot produce a response matching the list of acceptable values defined in the request headers.

407

Proxy Authentication Required

Similar to 401 Unauthorized but authentication is needed to be done by a proxy.

408

Request Timeout

The server would like to shut down this unused connection.

409

Conflict

This response is sent when a request conflicts with the current state of the server.

410

Gone

The content has been permanently deleted from server, with no forwarding address.

411

Length Required

Server rejected the request because the Content-Length header field is not defined.

412

Precondition Failed

The client has indicated preconditions in its headers which the server does not meet.

413

Payload Too Large

Request entity is larger than limits defined by server.

414

URI Too Long

The URI requested by the client is longer than the server is willing to interpret.

415

Unsupported Media Type

The media format of the requested data is not supported by the server.

416

Range Not Satisfiable

The range specified by the Range header field in the request cannot be fulfilled.

417

Expectation Failed

The expectation indicated by the Expect request header field cannot be met by the server.

418

I'm a Teapot

The server refuses the attempt to brew coffee with a teapot. (RFC 2324)

421

Misdirected Request

The request was directed at a server that is not able to produce a response.

422

Unprocessable Entity

The request was well-formed but was unable to be followed due to semantic errors.

423

Locked

The resource that is being accessed is locked.

424

Failed Dependency

The request failed because it depended on another request and that request failed.

425

Too Early

Indicates that the server is unwilling to risk processing a request that might be replayed.

426

Upgrade Required

The server refuses to perform the request using the current protocol.

428

Precondition Required

The origin server requires the request to be conditional.

429

Too Many Requests

The user has sent too many requests in a given amount of time (rate limiting).

431

Request Header Fields Too Large

The server is unwilling to process the request because its header fields are too large.

451

Unavailable For Legal Reasons

The user agent requested a resource that cannot legally be provided.

5xx Server Error

500

Internal Server Error

The server has encountered a situation it does not know how to handle.

501

Not Implemented

The request method is not supported by the server and cannot be handled.

502

Bad Gateway

The server, while acting as a gateway, got an invalid response.

503

Service Unavailable

The server is not ready to handle the request. Common causes are maintenance or overload.

504

Gateway Timeout

The server is acting as a gateway and cannot get a response in time.

505

HTTP Version Not Supported

The HTTP version used in the request is not supported by the server.

506

Variant Also Negotiates

The server has an internal configuration error.

507

Insufficient Storage

The method could not be performed on the resource because the server is unable to store the representation.

508

Loop Detected

The server detected an infinite loop while processing the request.

510

Not Extended

Further extensions to the request are required for the server to fulfill it.

511

Network Authentication Required

The client needs to authenticate to gain network access.

Der HTTP Status Code Lookup bietet sofortigen Zugriff auf detaillierte Erklärungen für jeden HTTP-Antwort-Statuscode von 100 bis 599, einschließlich RFC-Referenzen, häufiger Anwendungsfälle und der feinen Unterschiede zwischen oft verwechselten Codes. Geben Sie einen Code wie 403 ein oder suchen Sie nach einem Stichwort wie "redirect", um den offiziellen Namen, die Bedeutung und praktische Hinweise zur Verwendung in Ihren eigenen APIs zu erhalten.

HTTP-Statuscodes verstehen

Jede HTTP-Antwort beginnt mit einem dreistelligen Statuscode, der dem Client mitteilt, was mit seiner Anfrage passiert ist. Wenn Sie jemals eine 404-Seite gesehen, einen 500-Fehler von einer API erhalten oder durch einen 301 stillschweigend weitergeleitet wurden, haben Sie Statuscodes in Aktion erlebt. Sie sind das Erste, was Ihr Browser, HTTP-Client oder Überwachungssystem prüft, wenn eine Antwort eintrifft, und die Wahl des richtigen Codes in Ihren eigenen APIs ist entscheidend für den Aufbau von Systemen, die sich vorhersehbar verhalten und leicht zu debuggen sind.

Statuscodes werden anhand ihrer ersten Ziffer in fünf Klassen eingeteilt. Die 1xx-Codes sind informativ -- der Server bestätigt die Anfrage, hat die Verarbeitung aber noch nicht abgeschlossen. Die 2xx-Codes zeigen Erfolg an -- die Anfrage wurde empfangen, verstanden und korrekt verarbeitet. Die 3xx-Codes behandeln Weiterleitungen -- der Client muss eine zusätzliche Aktion ausführen, in der Regel einer neuen URL folgen. Die 4xx-Codes signalisieren Client-Fehler -- die Anfrage war fehlerhaft, nicht autorisiert oder zeigte auf etwas, das nicht existiert. Und die 5xx-Codes zeigen Server-Fehler an -- der Server hat die Anfrage verstanden, konnte sie aber aufgrund eines internen Problems nicht verarbeiten.

Die Herausforderung besteht nicht darin zu wissen, dass 200 Erfolg und 404 nicht gefunden bedeutet -- das ist allgemein bekannt. Die eigentliche Komplexität liegt in den feinen Unterschieden. Sollten Sie 401 oder 403 verwenden, wenn einem Benutzer die Berechtigung fehlt? Ist 301 oder 308 die richtige Weiterleitung für einen POST-Endpunkt, der umgezogen ist? Sollte eine Suche ohne Ergebnisse 200 mit einem leeren Body, 204 oder 404 zurückgeben? Dieses Tool erklärt diese Unterschiede mit praktischen Hinweisen, damit Sie die richtige Wahl für Ihren spezifischen Anwendungsfall treffen können.

So schlagen Sie einen HTTP-Statuscode nach

Geben Sie eine Statuscode-Nummer ein (z. B. 404) oder suchen Sie nach einem Stichwort (z. B. "redirect", "unauthorized").
Sehen Sie den offiziellen Namen, die RFC-Referenz und die detaillierte Erklärung.
Lesen Sie die Anwendungshinweise, wann Sie diesen Code in Ihrer eigenen API zurückgeben sollten.

HTTP-Statuscode-Kurzreferenz

Informativ (1xx)

Code	Name	Bedeutung
`100`	Continue	Server hat Anfrage-Header empfangen; Client sollte den Body senden
`101`	Switching Protocols	Server wechselt zum über den `Upgrade`-Header angeforderten Protokoll (z. B. WebSocket)
`103`	Early Hints	Server sendet vorläufige Header (z. B. `Link` zum Vorladen) vor der endgültigen Antwort

Erfolg (2xx)

Code	Name	Bedeutung
`200`	OK	Standard-Erfolgsantwort
`201`	Created	Ressource wurde erfolgreich erstellt (üblich bei POST)
`204`	No Content	Erfolg, aber kein Body zurückzugeben (üblich bei DELETE)
`206`	Partial Content	Server gibt einen Bereich der Ressource zurück (verwendet mit `Range`-Header)

Weiterleitung (3xx)

Code	Name	Bedeutung
`301`	Moved Permanently	Ressource hat eine neue permanente URL; Suchmaschinen aktualisieren ihren Index
`302`	Found	Temporäre Weiterleitung; historisch mehrdeutig bezüglich der Methodenbeibehaltung
`304`	Not Modified	Zwischengespeicherte Version ist noch gültig; kein Body zurückgegeben
`307`	Temporary Redirect	Wie 302, aber garantiert, dass die HTTP-Methode nicht geändert wird
`308`	Permanent Redirect	Wie 301, aber garantiert, dass die HTTP-Methode nicht geändert wird

Client-Fehler (4xx)

Code	Name	Bedeutung
`400`	Bad Request	Server kann die Anfrage aufgrund fehlerhafter Syntax nicht verarbeiten
`401`	Unauthorized	Authentifizierung ist erforderlich und ist fehlgeschlagen oder wurde nicht bereitgestellt
`403`	Forbidden	Server hat die Anfrage verstanden, weigert sich aber, sie zu autorisieren
`404`	Not Found	Angefragte Ressource existiert nicht
`405`	Method Not Allowed	HTTP-Methode wird für diesen Endpunkt nicht unterstützt
`409`	Conflict	Anfrage kollidiert mit dem aktuellen Zustand der Ressource
`410`	Gone	Ressource existierte, wurde aber dauerhaft entfernt
`429`	Too Many Requests	Ratenlimit überschritten

Server-Fehler (5xx)

Code	Name	Bedeutung
`500`	Internal Server Error	Allgemeiner serverseitiger Fehler
`502`	Bad Gateway	Upstream-Server hat eine ungültige Antwort zurückgegeben
`503`	Service Unavailable	Server ist vorübergehend überlastet oder in Wartung
`504`	Gateway Timeout	Upstream-Server hat nicht rechtzeitig geantwortet

Häufig verwechselte Statuscodes

301 vs. 302 vs. 307 vs. 308

301 Moved Permanently -- Verwenden Sie dies, wenn sich die URL einer Ressource dauerhaft geändert hat. Browser und Suchmaschinen können bei der Weiterleitung POST zu GET ändern.
302 Found -- Temporäre Weiterleitung. Historisch haben Browser POST zu GET geändert, obwohl die Spezifikation dies nicht vorsah. In der Praxis mehrdeutig.
307 Temporary Redirect -- Wie 302, aber der Browser muss die ursprüngliche HTTP-Methode beibehalten (POST bleibt POST).
308 Permanent Redirect -- Wie 301, aber der Browser muss die ursprüngliche HTTP-Methode beibehalten. Verwenden Sie dies statt 301, wenn Sie Formularübermittlungen weiterleiten.

401 vs. 403

401 Unauthorized -- Der Client hat keine gültigen Authentifizierungsdaten bereitgestellt. Die Antwort sollte einen WWW-Authenticate-Header enthalten, der das erwartete Authentifizierungsschema angibt.
403 Forbidden -- Der Client ist authentifiziert (oder eine Authentifizierung ist nicht erforderlich), hat aber keine Berechtigung, auf die Ressource zuzugreifen. Eine erneute Authentifizierung hilft nicht.

404 vs. 410

404 Not Found -- Die Ressource ist nicht verfügbar. Sie hat möglicherweise nie existiert oder könnte in Zukunft existieren.
410 Gone -- Die Ressource existierte zuvor, wurde aber absichtlich und dauerhaft entfernt. Suchmaschinen deindexieren die URL mit 410 schneller als mit 404.

500 vs. 502 vs. 503 vs. 504

500 -- Der Server selbst ist bei der Verarbeitung der Anfrage auf einen Fehler gestoßen (unbehandelte Ausnahme, Bug).
502 -- Ein Reverse-Proxy oder Load-Balancer hat eine ungültige Antwort von einem Upstream-Server erhalten.
503 -- Der Server kann vorübergehend keine Anfragen verarbeiten (überlastet, in Wartung). Enthält oft einen Retry-After-Header.
504 -- Ein Reverse-Proxy oder Load-Balancer hat auf die Antwort eines Upstream-Servers gewartet und ein Timeout erhalten.

Wann Sie dieses Tool verwenden sollten

Entwurf von RESTful APIs -- Semantisch korrekte Statuscodes für jeden Endpunkt und jede Fehlerbedingung wählen.
Debugging von API-Antworten -- Verstehen, was ein unbekannter oder unerwarteter Statuscode in Server-Logs bedeutet.
Umgang mit Weiterleitungen -- Bestimmen, ob 301, 302, 307 oder 308 für Ihr spezifisches Weiterleitungsszenario geeignet ist.
Konfiguration von Monitoring-Alarmen -- Alarme für bestimmte Statuscodes einrichten mit Verständnis dessen, was jeder einzelne anzeigt.
SEO-Optimierung -- Die richtigen Weiterleitungscodes (301 vs. 302) verwenden, um Suchmaschinen-Rankings bei URL-Migrationen beizubehalten.
Incident-Triage -- Schnell feststellen, ob ein 5xx-Fehler von Ihrer Anwendung (500) oder von der Infrastruktur (502, 504) stammt.

Praktische Hinweise für API-Statuscodes

Einer der häufigsten API-Designfehler ist die übermäßige Verwendung von 200 OK für alles, einschließlich Fehler. Einige APIs geben 200 mit einer Fehlermeldung im Body zurück, was den Client zwingt, die Antwort zu parsen, um festzustellen, ob die Anfrage tatsächlich erfolgreich war. Dies bricht Standard-HTTP-Tooling, macht Monitoring unzuverlässig und verwirrt Entwickler, die erwarten, dass HTTP-Statuscodes das tatsächliche Ergebnis widerspiegeln. Verwenden Sie 200 für Erfolg, 4xx für Client-Fehler und 5xx für Server-Fehler -- dafür sind die Codes da.

Eine weitere häufige Verwirrungsquelle ist die Wahl zwischen 404 und leeren Erfolgsantworten. Wenn ein Benutzer nach Produkten sucht und die Suche keine Ergebnisse liefert, ist die korrekte Antwort 200 mit einem leeren Array -- der Such-Endpunkt existiert, er hat funktioniert und nichts gefunden. Wenn der Benutzer ein bestimmtes Produkt anhand der ID anfragt und dieses Produkt nicht existiert, ist die korrekte Antwort 404 -- die angefragte Ressource ist nicht vorhanden. Der Unterschied besteht zwischen "Ich habe getan, was du verlangt hast, und die Antwort ist nichts" (200) versus "Das, wonach du gefragt hast, existiert nicht" (404).

Für APIs, die sowohl authentifizierte als auch nicht authentifizierte Benutzer bedienen, sollten Sie darauf achten, welche Informationen Sie durch Statuscodes preisgeben. Mit 403 auf eine nicht autorisierte Anfrage für /admin/users zu antworten, bestätigt, dass der Endpunkt existiert. Mit 404 zu antworten, verrät hingegen nichts über Ihre URL-Struktur. Die Sicherheitsgemeinde nennt dies "Security through Obscurity", und es hat seine Grenzen, aber es ist eine vernünftige Defense-in-Depth-Maßnahme für sensible Endpunkte.

Häufig gestellte Fragen

Was sind die benutzerdefinierten 5xx-Statuscodes von CloudFlare?

CloudFlare verwendet die Codes 520 bis 527 für Probleme zwischen ihren Edge-Servern und Origin-Servern. Zum Beispiel bedeutet 520, dass der Origin eine unerwartete Antwort zurückgab, 521 bedeutet, dass der Origin-Webserver nicht erreichbar ist, 522 bedeutet, dass die Verbindung zum Origin ein Timeout hatte, und 524 bedeutet, dass der Origin geantwortet hat, aber zu lange gebraucht hat.

Gibt es einen Unterschied zwischen "Unauthorized" und "Unauthenticated"?

Technisch gesehen sollte HTTP 401 "Unauthenticated" heißen, weil es bedeutet, dass der Client seine Identität nicht nachgewiesen hat. Der Name "Unauthorized" ist ein historischer Fehlbenennung in der Spezifikation. Ein tatsächlicher Autorisierungsfehler (Sie sind authentifiziert, haben aber keine Berechtigung) ist 403 Forbidden.

Sollte ich 404 oder 204 verwenden, wenn eine Suche keine Ergebnisse liefert?

Verwenden Sie 200 mit einer leeren Ergebnismenge. Die Ressource (der Such-Endpunkt) existiert und hat erfolgreich geantwortet -- sie hat nur keine übereinstimmenden Einträge gefunden. Reservieren Sie 404 für den Fall, dass der Endpunkt selbst nicht existiert.

Wann sollte ich 429 Too Many Requests verwenden?

Verwenden Sie 429, wenn ein Client das Ratenlimit Ihrer API überschritten hat. Fügen Sie einen Retry-After-Header hinzu, der angibt, wie viele Sekunden der Client warten soll, bevor er es erneut versucht. Fügen Sie außerdem X-RateLimit-Limit- und X-RateLimit-Remaining-Header hinzu, damit Clients ihren aktuellen Kontingent-Status sehen können, ohne das Limit zu erreichen.

Was ist der Unterschied zwischen 502 und 504 bei einem Reverse-Proxy-Setup?

Ein 502 Bad Gateway bedeutet, dass der Proxy eine Antwort vom Upstream-Server erhalten hat, aber die Antwort ungültig oder fehlerhaft war (z. B. der Upstream hat fehlerhafte Daten zurückgegeben oder die Verbindung mitten in der Antwort geschlossen). Ein 504 Gateway Timeout bedeutet, dass der Proxy überhaupt keine Antwort erhalten hat -- der Upstream-Server hat nicht innerhalb der konfigurierten Timeout-Periode geantwortet. Beide weisen auf Upstream-Probleme hin, aber 504 deutet typischerweise darauf hin, dass der Upstream überlastet oder nicht erreichbar ist, während 502 darauf hindeutet, dass er antwortet, aber sich fehlerhaft verhält.

Sollte ich 201 Created oder 200 OK nach dem Erstellen einer Ressource zurückgeben?

Verwenden Sie 201 Created für POST-Anfragen, die eine neue Ressource erstellen. Fügen Sie einen Location-Header hinzu, der auf die URL der neu erstellten Ressource verweist. Dies folgt den REST-Konventionen und hilft Clients, die neue Ressource zu finden, ohne den Antwort-Body parsen zu müssen. Verwenden Sie 200 für Aktualisierungen bestehender Ressourcen (PUT/PATCH).