HTTP-Statuscodes — alle Codes 100–599, nginx, Cloudflare

Was die Seite HTTP-Statuscodes bietet

HTTP-Statuscodes ist ein durchsuchbares Nachschlagewerk für Antwortcodes im Bereich von 100 bis 599. Es hilft beim Debuggen von API-Aufrufen, beim Schreiben von Dokumentation, bei der Wahl der Antwort für einen neuen Endpunkt, beim Lesen von Logs, beim Prüfen des Gateway-Verhaltens oder beim Erklären eines Fehlers gegenüber anderen Entwicklern. Jeder Eintrag enthält den numerischen Code, den Reason-Phrase-Text, die Kategorie, das RFC, das ihn definiert, und eine kurze Beschreibung dessen, was die Antwort üblicherweise bedeutet. Filter-Chips grenzen die Liste auf informative, erfolgreiche, Weiterleitungs-, Client-Fehler- oder Server-Fehler-Codes ein.

Im echten Datenverkehr tauchen auch Codes auf, die kein Standard definiert. Ein 499 in einem nginx-Log bedeutet, dass der Client aufgegeben hat, bevor der Server geantwortet hat; ein 522 von Cloudflare bedeutet, dass der Ursprungsserver den TCP-Handshake nicht abgeschlossen hat; ein 460 oder 561 stammt von einem AWS Load Balancer. Diese inoffiziellen Codes stehen in einer eigenen Gruppe zusammen mit dem Produkt, das sie ausgibt, sodass Sie schnell erkennen, ob ein Fehler von Ihrer Anwendung, einem Proxy oder einem CDN stammt. Ein Klick auf ein Ergebnis kopiert Code und Phrase für Issue-Kommentare, Dokumente, Tests oder Endpunkt-Notizen.

Privater Workflow im Browser

Die gesamte Verarbeitung findet in Ihrem Browser mit clientseitigem JavaScript statt. Die Liste ist direkt in die Seite eingebettet und wird nicht von einem Dienst abgerufen. Das macht sie schnell und verfügbar, auch wenn Sie offline arbeiten oder Netzwerkprobleme debuggen, und nichts, was Sie eingeben, wird irgendwohin gesendet.

Praktische Tipps

Statuscodes sind Teil eines API-Vertrags, wählen Sie sie daher bewusst. Verwenden Sie Antworten der 400er-Reihe, wenn der Client die Anfrage ändern kann, Antworten der 500er-Reihe, wenn der Server eine gültige Anfrage nicht erfüllen konnte, und Antworten der 300er-Reihe, wenn der Client woanders nachsehen soll. Authentifizierungs- und Autorisierungsfehler werden oft verwechselt: 401 bedeutet meist, dass eine Authentifizierung erforderlich oder ungültig ist, während 403 bedeutet, dass der authentifizierte Aufrufer nicht berechtigt ist. Bevorzugen Sie 422 für Validierungsfehler in einem wohlgeformten Body, 409 für Zustandskonflikte und 429 mit einem Retry-After-Header für Ratenbegrenzung. Geben Sie in Ihrer eigenen API niemals inoffizielle Codes zurück — Clients und Bibliotheken verstehen sie möglicherweise nicht.