Co to znaczy
Żądanie nie ma prawidłowych danych uwierzytelniających. Mimo nazwy oznacza brak uwierzytelnienia: zaloguj się lub wyślij prawidłowy token.
Typowe przyczyny
- Brak nagłówka Authorization
- Wygasły lub unieważniony token
- Zła nazwa użytkownika, hasło lub klucz API
Jak naprawić
Jako klient lub odwiedzający
Wyślij dane uwierzytelniające w formacie, o który prosi nagłówek WWW-Authenticate, odśwież wygasłe tokeny i sprawdź literówki lub klucz z niewłaściwego środowiska.
Jako właściciel strony lub API
Zawsze dołączaj nagłówek WWW-Authenticate do 401. Użyj 403, gdy użytkownik jest uwierzytelniony, ale nie ma uprawnień.
Przykładowa odpowiedź
HTTP/1.1
HTTP/1.1 401 Unauthorized
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
WWW-Authenticate: Bearer realm="api", error="invalid_token"
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Unauthorized",
"status": 401,
"detail": "The access token expired."
}Specyfikacja
FAQ
› 401 czy 403?
401: nie wiemy, kim jesteś, uwierzytelnij się. 403: wiemy, kim jesteś, i nie wolno ci tego zrobić.
› Dlaczego dostaję 401 zaraz po zalogowaniu?
Zwykle token nie jest dołączany do żądań (CORS bez credentials, zła nazwa nagłówka) albo przesunięcie zegara sprawia, że wygląda na wygasły.