HTTP-Statuscode-Referenz

HTTP-Statuscodes verstehen

HTTP-Statuscodes sind dreistellige Zahlen, die ein Server als Antwort auf jede HTTP-Anfrage zurueckgibt. Sie sind Teil der HTTP-Spezifikation und bieten eine standardisierte Moeglichkeit fuer Server, dem Client das Ergebnis einer Anfrage mitzuteilen. Wenn Sie eine Webseite besuchen, sendet Ihr Browser eine HTTP-Anfrage an den Server, und der Server antwortet mit einem Statuscode zusammen mit dem angeforderten Inhalt oder einer Fehlermeldung. Das Verstaendnis dieser Codes ist grundlegend fuer Webentwicklung, API-Design, Serveradministration und die Fehlersuche bei Netzwerkproblemen.

Statuscodes sind in fuenf Klassen gruppiert, basierend auf ihrer ersten Ziffer. Jede Klasse repraesentiert eine andere Art von Antwort. Die 1xx-Codes sind informativ und zeigen an, dass die Anfrage empfangen wurde und die Verarbeitung fortgesetzt wird. Die 2xx-Codes signalisieren Erfolg, was bedeutet, dass die Anfrage empfangen, verstanden und akzeptiert wurde. Die 3xx-Codes zeigen eine Umleitung an und teilen dem Client mit, dass zusaetzliche Massnahmen erforderlich sind, um die Anfrage abzuschliessen. Die 4xx-Codes stellen Client-Fehler dar, bei denen die Anfrage fehlerhafte Syntax enthaelt oder nicht erfuellt werden kann. Die 5xx-Codes zeigen Server-Fehler an, bei denen der Server eine gueltige Anfrage nicht erfuellen konnte.

Die fuenf Statuscode-Kategorien

1xx Informative Antworten

Informative Antworten zeigen an, dass der Server die Anfrage empfangen hat und sie weiter verarbeitet. Der bemerkenswerteste ist 100 Continue, der dem Client mitteilt, mit dem Senden des Anfragekoeprers fortzufahren, nachdem nur die Header gesendet wurden. Dies ist nuetzlich fuer grosse Uploads, bei denen der Client pruefen moechte, ob der Server die Anfrage akzeptiert, bevor ein moeglicherweise grosses Datenpaket uebertragen wird. 103 Early Hints ist eine neuere Ergaenzung, die es dem Server ermoeglicht, vorlaefige Header vor der endgueltigen Antwort zu senden, sodass der Browser Stylesheets und Skripte vorladen kann, waehrend der Server die Hauptantwort vorbereitet.

2xx Erfolgscodes

Erfolgscodes bestaetigen, dass die Anfrage korrekt verarbeitet wurde. 200 OK ist der haeufigste und wird fuer standardmaessige erfolgreiche GET-Anfragen zurueckgegeben. 201 Created wird verwendet, wenn eine neue Ressource erstellt wurde, typischerweise als Antwort auf eine POST-Anfrage. 204 No Content zeigt Erfolg ohne Antwortkoerper an und wird haeufig fuer DELETE-Operationen und API-Aktionen verwendet, die keine Daten zurueckgeben muessen. 206 Partial Content unterstuetzt Bereichsanfragen, die es Clients ermoeglichen, grosse Dateien in Abschnitten herunterzuladen oder unterbrochene Downloads fortzusetzen.

3xx Umleitung und 4xx/5xx Fehlercodes

Umleitungscodes weisen den Client an, die angeforderte Ressource anderswo zu suchen. Die Unterscheidung zwischen 301 Moved Permanently und 302 Found ist fuer SEO entscheidend, da Suchmaschinen sie bei der Uebertragung von Link-Autoritaet unterschiedlich behandeln. Client-Fehlercodes im 4xx-Bereich decken alles ab, von fehlerhaften Anfragen (400) ueber Authentifizierungsfehler (401, 403), fehlende Ressourcen (404) bis hin zur Ratenbegrenzung (429). Server-Fehlercodes im 5xx-Bereich zeigen Probleme auf der Serverseite an, von allgemeinen Fehlern (500) ueber Bad-Gateway-Antworten (502) bis hin zu Nichtverfuegbarkeit des Dienstes (503). Die Ueberwachung dieser Codes hilft Betriebsteams, Probleme schnell zu identifizieren und zu beheben.

Haeufige Statuscodes in der API-Entwicklung

RESTful APIs stuetzen sich stark auf Statuscodes zur Kommunikation von Ergebnissen. Eine gut gestaltete API verwendet 200 fuer erfolgreiche Lesevorgaenge, 201 fuer erfolgreiche Erstellungen, 204 fuer erfolgreiche Loeschungen, 400 fuer Validierungsfehler, 401 fuer fehlende Authentifizierung, 403 fuer unzureichende Berechtigungen, 404 fuer nicht vorhandene Ressourcen, 409 fuer Konflikte wie doppelte Eintraege, 422 fuer semantisch ungueltige Anfragen und 429 fuer ratenbegrenzte Anfragen. Die konsistente Verwendung von Statuscodes macht APIs vorhersehbar und fuer Nutzer einfacher zu integrieren.

Haeufig gestellte Fragen

Was sind HTTP-Statuscodes?

Dreistellige Zahlen, die von Webservern zurueckgegeben werden und das Ergebnis einer Anfrage anzeigen. Sie sind in fuenf Klassen gruppiert: 1xx Informativ, 2xx Erfolg, 3xx Umleitung, 4xx Client-Fehler und 5xx Server-Fehler.

Was bedeuten 4xx-Statuscodes?

4xx-Codes zeigen Client-Fehler an. Die Anfrage war fehlerhaft, nicht autorisiert oder verwies auf eine fehlende Ressource. Haeufige Beispiele sind 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found und 429 Too Many Requests.

Was ist der Unterschied zwischen 301- und 302-Weiterleitungen?

301 ist eine permanente Weiterleitung, die Browsern und Suchmaschinen mitteilt, ihre URLs zu aktualisieren. 302 ist eine voruebergehende Weiterleitung, bei der die urspruengliche URL weiterhin fuer zukuenftige Anfragen verwendet werden soll. 301 uebertraegt SEO-Link-Autoritaet; 302 nicht.

Was ist HTTP-Statuscode 418?

Ein Aprilscherz aus RFC 2324, der das Hyper Text Coffee Pot Control Protocol definiert. Eine Teekanne gibt 418 zurueck, wenn sie gebeten wird, Kaffee zu kochen. Trotz des humorvollen Ursprungs wurde er als Easter Egg weitverbreitet implementiert.

Wann sollte ich eine 204 No Content-Antwort verwenden?

Verwenden Sie 204 fuer erfolgreiche Anfragen, die keinen Antwortkoerper benoetigen, wie DELETE-Operationen, erfolgreiche Updates bei denen der Client die Daten bereits hat, und Fire-and-Forget-API-Aktionen.