HTTP 401 Unauthorized

Die Authentifizierung fehlt oder ist ungültig. Trotz des Namens geht es hier um die Identität, nicht um Berechtigungen – der Server weiß nicht, wer Sie sind.

Definiert in RFC 9110 §15.5.2 — 401 Unauthorized · MDN-Referenz

Wo Ihnen HTTP 401 in der Praxis begegnet

Ein fehlender Authorization-Header, ein abgelaufenes Access-Token, eine nicht verifizierbare Signatur, eine widerrufene Sitzung.

Warum Sie ihn testen sollten

Testen Sie den Fall „Header fehlt“ und den Fall „Token ungültig“ getrennt. Es sind unterschiedliche Fehler, und sie scheitern an unterschiedlichen Stellen.

Was Ihr Client bei einem 401 tun sollte

Ein 401-Fehler bedeutet "authenticate and try again" – aktualisieren Sie das Token einmal und versuchen Sie es erneut, dann beenden Sie den Vorgang. Eine endlose Aktualisierungsschleife führt dazu, dass ein einzelnes abgelaufenes Benutzerkonto zu einer anhaltenden Lastspitze wird. Ein kompatibler Server sendet einen WWW-Authenticate-Header, der das gewünschte Authentifizierungsschema angibt.

401 und die Codes, mit denen er verwechselt wird

Endpunkte, die 401 zurückgeben

122 Endpunkte dieses Playgrounds antworten mit 401. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

…und 97 weitere Endpunkte im Katalog.

Fragen zu HTTP 401

Warum heißt es „nicht autorisiert“, wenn es doch „nicht authentifiziert“ bedeutet?
Ein Benennungsfehler in der ursprünglichen Spezifikation, der inzwischen dauerhaft ist. Lesen Sie 401 als „nicht authentifiziert“.
Soll ich es nach einem 401-Fehler erneut versuchen?
Einmal, nachdem die Zugangsdaten erneuert wurden. Werden auch die erneuerten abgelehnt, ist das Problem nicht vorübergehend.

Weitere Client-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert