401 Unauthorized
Serverul nu știe cine ești: tokenul lipsește, e expirat sau invalid, sau cheia API nu e trimisă. Obține un token nou (login) și verifică în Console că antetul Authorization chiar pleacă cu cererea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
401 Unauthorized înseamnă, de fapt, „neautentificat”: serverul nu a primit o identitate validă. Nu spune că n-ai drepturi (pentru asta există 403), ci că nu știe cine ești.
Cauze frecvente în Postman:
- nu ai făcut login, deci
{{token}}e gol sau nerezolvat; - tokenul a expirat;
- cererea are No Auth în loc de Inherit, deci nu trimite tokenul colecției;
- tokenul e copiat cu ghilimele sau cu spații;
- cheia API e în alt antet decât cel așteptat.
Body-ul răspunsului spune adesea motivul (token_expired, invalid_token, „Lipsește tokenul”), iar antetul WWW-Authenticate arată schema cerută. În Console verifici antetul Authorization trimis efectiv.
De ce apare: cauzele frecvente
1Login-ul nu a fost făcut
GET {{baseUrl}}/auth/me # token inexistentPOST /auth/login → salvează token
GET {{baseUrl}}/auth/meFără token, serverul nu are ce verifica.
2Cererea nu moștenește autentificarea
Authorization: No AuthAuthorization: Inherit auth from parentCu No Auth, tokenul colecției nu se mai trimite.
3Token expirat
{"error": "token_expired"}# login din nou sau refresh automat în pre-requestTokenurile au o durată limitată.
Repară eroarea, direct în pagină
Cererea „Profil” (GET {{baseUrl}}/auth/me) moștenește Bearer {{token}} de la colecție, dar a fost trimisă înainte de login și a primit 401. Trimite „Login” (scriptul salvează tokenul), apoi din nou „Profil”: trebuie să primești 200 cu datele Anei.
Indiciu
Tokenul se obține la login.
Reparația
1. Trimite Login. 2. Trimite Profil: antetul Authorization: Bearer <token> pleacă acum cu tokenul salvat.
De ce merge
Profil cere autentificare. Înainte de login, {{token}} nu exista, deci serverul nu avea identitate de verificat. După login, cererea moștenește tokenul de la colecție și serverul o acceptă. 401 înseamnă că serverul nu știe cine ești: tokenul lipsește, e invalid sau a expirat. După ce cererea trimite un token valid, serverul identifică utilizatorul și răspunde cu datele cerute.
Alte forme ale mesajului
401 Unauthorized: Lipsește tokenul de autentificare.HTTP 401{"message": "Unauthorized"}
Cum o eviți pe viitor
- Automatizează salvarea tokenului după login și reîmprospătarea lui.
- Setează autentificarea pe colecție, iar cererile pe Inherit.
- Testează intenționat cazurile fără token și cu token expirat (răspunsul așteptat e 401).
- Verifică în Console antetul
Authorizationtrimis efectiv, după rezolvarea variabilelor.
Întrebări frecvente
Ce diferență e între 401 și 403?
401: nu știu cine ești. 403: știu cine ești, dar nu ai voie.
De ce primesc 401 deși am făcut login?
Tokenul poate fi salvat în alt scope sau alt environment, ori cererea are No Auth. Verifică în Console antetul trimis.
Erori înrudite
403 Forbidden Serverul știe cine ești, dar contul tău nu are dreptul la această operație sau resursă (de exemplu un client care cere lista de utilizatori, rezervată adminilor). Folosește un cont cu rolul potrivit; dacă ar trebui să ai acces, raportează problema de permisiuni. 401 Unauthorized: jwt expired Tokenul JWT a trecut de momentul de expirare (claim-ul exp), deci serverul nu-l mai acceptă. Fă din nou login (sau folosește refresh token-ul) și salvează tokenul nou; ca să nu se mai întâmple, reîmprospătează-l automat într-un pre-request al colecției. Missing Authorization Header Cererea nu trimite antetul Authorization, deși endpointul îl cere: de obicei cererea are No Auth în loc de Inherit auth from parent, sau tokenul colecției e gol. Setează autentificarea cererii pe Inherit (sau Bearer {{token}}) și verifică antetul în Console. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
