...
Eroare Postman · Coduri de status 4xx și 5xx: ce înseamnă și cum le repari

401 Unauthorized

Pe scurt

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

Greșit
JavaScript
GET {{baseUrl}}/auth/me   # token inexistent
Corect
JavaScript
POST /auth/login  → salvează token
GET {{baseUrl}}/auth/me

Fără token, serverul nu are ce verifica.

2Cererea nu moștenește autentificarea

Greșit
JavaScript
Authorization: No Auth
Corect
JavaScript
Authorization: Inherit auth from parent

Cu No Auth, tokenul colecției nu se mai trimite.

3Token expirat

Greșit
JavaScript
{"error": "token_expired"}
Corect
JavaScript
# login din nou sau refresh automat în pre-request

Tokenurile au o durată limitată.

Repară tu

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.

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 Authorization trimis 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

← Toate erorile Postman

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.