HTTP-Statuscodes

Referenz für HTTP-Statuscodes

Entwickler-Tools

Verwendung von HTTP-Statuscodes

  1. 1Nach Code-Nummer oder Schlüsselwort suchen
  2. 2Nach Kategorie durchsuchen (2xx, 3xx, usw.)
  3. 3Auf beliebigen Code für vollständige Details klicken

Über HTTP-Statuscodes

HTTP-Statuscodes ist eine umfassende Referenz für alle Standard- und häufig verwendeten HTTP-Antwortstatuscodes, nach Kategorie geordnet. Jeder Code enthält eine einfachsprachige Beschreibung, wann er angemessen zu verwenden ist, und Beispiele aus der Praxis.

HTTP-Statuscodes sind der primäre Mechanismus, durch den Server das Ergebnis einer Anfrage kommunizieren. Jeder Entwickler, der mit REST-APIs arbeitet, muss wissen, was 200, 201, 204, 301, 400, 401, 403, 404, 422, 429 und 500 bedeuten.

Suchen oder filtern Sie nach Code-Nummer, Kategorie (1xx-5xx) oder Schlüsselwort um jeden Code sofort zu finden.

Hauptfunktionen von HTTP-Statuscodes

  • Vollständige Referenz für alle Standard-HTTP-Statuscodes (1xx-5xx)
  • Enthält nicht-standardmäßige aber weit verwendete Codes: 418, 429, 451
  • Einfachsprachige Beschreibung für jeden Code
  • Suche nach Code-Nummer oder Schlüsselwort
  • Filtern nach Kategorie: 1xx Informational, 2xx Success, 3xx Redirection, 4xx Client Error, 5xx Server Error
  • Häufige Anwendungsfälle und Beispiele für jeden Code
  • Läuft vollständig im Browser — keine Server-Anfragen
  • Schnelle Sofortsuche ohne Ladeverzögerung

Beispiele

Korrekten Code für erfolgreiche Ressourcenerstellung finden

Herausfinden welchen 2xx-Code ein POST-Endpoint zurückgeben soll der eine neue Ressource erstellt.

Eingabe

Suche: "created" oder Code 201

Ausgabe

201 Created — Verwendet wenn eine neue Ressource erstellt wurde. Location-Header einschließen der auf die neue Ressource-URL zeigt.

Richtigen Fehlercode für eine rate-limitierte API-Antwort finden

Standardcode identifizieren um zu kommunizieren dass ein Client API-Rate-Limits überschritten hat.

Eingabe

Suche: "rate limit" oder Code 429

Ausgabe

429 Too Many Requests — Retry-After-Header einschließen der angibt wann der Client erneut versuchen kann.

Typische Anwendungsfälle

  • Suche nach dem korrekten Statuscode der von einem REST-API-Endpoint zurückzugeben ist
  • Debuggen von HTTP-Fehlern durch Verstehen was ein bestimmter Code bedeutet
  • Entwerfen der Fehlerbehandlung in API-Client-Code für verschiedene Antwortkategorien
  • Lernen der HTTP-Semantik beim Erstellen oder Dokumentieren einer API
  • Überprüfung von API-Designs um sicherzustellen dass Statuscodes angemessen verwendet werden
  • Schnelle Referenz während der Entwicklung ohne den Browser-Tab zu verlassen

Fehlerbehebung

Verwendung von 200 OK für alle Antworten einschließlich Fehler

Lösung

Verwenden Sie immer den semantisch korrekten Statuscode. 200 mit einem Fehler im Body zurückzugeben bricht die HTTP-Semantik.

Verwechslung von 401 und 403

Lösung

401 Unauthorized bedeutet, dass der Client nicht authentifiziert ist. 403 Forbidden bedeutet, dass der Client authentifiziert ist, aber keine Berechtigung hat.

Verwendung von 404 für Authentifizierungsfehler

Lösung

404 für geschützte Ressourcen zurückzugeben ist eine Sicherheitstechnik zur Verhinderung von Enumeration, kann aber legitime Clients verwirren. Dokumentieren Sie Ihre Wahl klar.

Häufig gestellte Fragen

Sind alle HTTP-Statuscodes aufgeführt?

Ja. Alle Standard-RFC-7231-Statuscodes plus häufig verwendete inoffizielle Codes wie 418 (I'm a Teapot), 429 (Too Many Requests) und 451 (Unavailable for Legal Reasons) sind enthalten.

Was ist der Unterschied zwischen 401 und 403?

401 Unauthorized gibt an, dass die Anfrage Authentifizierung erfordert. 403 Forbidden gibt an, dass der Server die Anfrage versteht, aber die Autorisierung verweigert.

Wann 200 vs 201 vs 204 verwenden?

200 OK für erfolgreiche GET-Anfragen, 201 Created für erfolgreiche POST-Anfragen die eine Ressource erstellen, 204 No Content für DELETE oder PATCH ohne Antwort-Body.

Was bedeutet 422 Unprocessable Entity?

422 gibt an, dass die Anfrage wohlgeformt war, aber semantisch falsch ist. Häufig in REST-APIs für Validierungsfehler.

Was ist der korrekte Statuscode für eine Weiterleitung?

301 Moved Permanently für permanente URL-Änderungen, 302 Found für temporäre Weiterleitungen, und 307/308 um die HTTP-Methode während der Weiterleitung beizubehalten.

Wann 503 statt 500 zurückgeben?

500 Internal Server Error gibt einen unerwarteten Fehler an. 503 Service Unavailable gibt an, dass der Server vorübergehend keine Anfragen bearbeiten kann.

Werden meine Daten an einen Server gesendet?

Nein. Die Statuscode-Referenz wird statisch in Ihrem Browser geladen. Keine Abfragen oder Interaktionen werden übertragen.

Was bedeutet der 1xx-Statuscodebereich?

1xx-Codes sind informativ — sie geben an, dass die Anfrage empfangen wurde und die Verarbeitung fortgesetzt wird. Der häufigste ist 100 Continue.