---
title: "błąd 401"
description: "Błąd 401 Unauthorized to odpowiedź HTTP oznaczająca brak poprawnego uwierzytelnienia. Zobacz, skąd się bierze, jak go naprawić i czym różni się od 403."
url: "https://nodea.pl/pl/slownik-pojec/bad-401"
lang: "pl"
updated: "2026-07-13"
---

# błąd 401

> Błąd 401 (Unauthorized) to kod odpowiedzi HTTP informujący, że dostęp do zasobu wymaga uwierzytelnienia — klient nie przekazał ważnych danych logowania, tokenu lub klucza API.

**Błąd 401** (Unauthorized) to kod odpowiedzi [HTTP](https://nodea.pl/pl/slownik-pojec/http) informujący, że żądanie nie zostało zrealizowane, ponieważ dostęp do zasobu wymaga uwierzytelnienia, a klient nie przekazał ważnych poświadczeń. Wbrew dosłownemu tłumaczeniu nazwy chodzi o brak uwierzytelnienia (authentication), nie autoryzacji — serwer nie wie, kim jest nadawca żądania.

## Jak działa błąd 401

Typowy przebieg wygląda tak: klient żąda chronionego zasobu bez poświadczeń, serwer odpowiada kodem 401 wraz z nagłówkiem WWW-Authenticate wskazującym oczekiwany schemat uwierzytelnienia (Basic, Bearer, Digest), a klient ponawia żądanie z nagłówkiem Authorization. W komunikacji z API najczęstsze źródła błędu to wygasły lub uszkodzony token [JWT](https://nodea.pl/pl/slownik-pojec/jwt), nieprawidłowy klucz API albo brak nagłówka Authorization w ogóle. W klasycznych serwisach WWW 401 zwraca zwykle ochrona katalogu mechanizmem Basic Auth (pliki .htpasswd) lub wygaśnięcie sesji użytkownika.

## Zastosowanie w praktyce

Diagnozę warto zacząć od poświadczeń: czy login i hasło są poprawne, czy token nie wygasł (pole exp w JWT) i czy jest wysyłany we właściwym nagłówku. Kolejne kroki to weryfikacja konfiguracji Basic Auth na serwerze, wyczyszczenie ciasteczek i pamięci podręcznej przeglądarki oraz sprawdzenie, czy adres nie wymaga innego mechanizmu logowania (np. tokenu OAuth zamiast klucza statycznego). Od strony bezpieczeństwa seria odpowiedzi 401 w logach serwera to cenny sygnał — może oznaczać próbę ataku brute force na panel logowania, którą warto ograniczyć narzędziami typu fail2ban lub limitem żądań. Różnicę względem pokrewnego kodu wyjaśnia hasło [błąd 403](https://nodea.pl/pl/slownik-pojec/bad-403): tam serwer rozpoznaje klienta, lecz świadomie odmawia dostępu. W nowoczesnych API dobrym zwyczajem jest zwracanie wraz z kodem 401 czytelnej treści błędu w formacie JSON, opisującej przyczynę (np. wygasły token) i sposób ponownego uwierzytelnienia, co znacząco upraszcza integrację i diagnostykę po stronie klienta.

### Czym różni się błąd 401 od 403?

Błąd 401 oznacza brak lub nieważność uwierzytelnienia — serwer nie wie, kim jest klient, i po podaniu poprawnych poświadczeń dostęp zostanie przyznany. Błąd 403 to odmowa dostępu mimo rozpoznania klienta: uwierzytelnienie nic nie zmieni, bo brakuje uprawnień.

## Powiązane

- [błąd 403](https://nodea.pl/pl/slownik-pojec/bad-403)
- [HTTP](https://nodea.pl/pl/slownik-pojec/http)
- [JWT](https://nodea.pl/pl/slownik-pojec/jwt)
- [OAuth](https://nodea.pl/pl/slownik-pojec/oauth)
- [Hasło](https://nodea.pl/pl/slownik-pojec/haslo)

---

Wersje językowe: [en](https://nodea.io/en/glossary/http-401-error.md)  
Spis treści witryny: [llms.txt](https://nodea.pl/pl/llms.txt)