...
Eroare Postman · Autentificare și tokenuri

401 Unauthorized: jwt expired

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un JWT conține în payload câmpul exp, momentul (în secunde Unix) după care nu mai e valid. Serverul compară exp cu ora lui și respinge tokenurile expirate cu 401. Mesajul exact diferă de la server la server: jwt expired (biblioteca jsonwebtoken din Node), token_expired, Token has expired; antetul WWW-Authenticate poate conține error="invalid_token", error_description="expired".

În Postman se întâmplă când tokenul salvat în environment a fost obținut acum o oră, iar durata lui e o oră. Totul mergea, apoi brusc toate cererile dau 401.

Reparația imediată: login din nou. Reparația de durată: salvezi la login și momentul expirării, iar un pre-request la nivel de colecție face login automat (cu pm.sendRequest) când tokenul lipsește sau expiră în curând.

De ce apare: cauzele frecvente

1Token vechi, salvat de ieri

Greșit
JavaScript
Environment Dev: token = eyJ... (exp trecut)
GET {{baseUrl}}/auth/me
Corect
JavaScript
POST /auth/login → salvează tokenul nou
GET {{baseUrl}}/auth/me

Un token nou are exp în viitor.

2Fără reîmprospătare automată

Greșit
JavaScript
// nimic în pre-request-ul colecției
Corect
JavaScript
if (Date.now() > Number(pm.environment.get("tokenExpira") || 0) - 30000) {
  // pm.sendRequest spre /auth/login și salvează tokenul
}

Scriptul obține un token nou înainte să expire cel vechi.

Repară tu

Repară eroarea, direct în pagină

Tokenul salvat în environment-ul Dev a expirat ieri, iar „Profil” răspunde 401 token_expired. Trimite „Login” (scriptul lui salvează tokenul nou în aceeași variabilă), apoi din nou „Profil”: trebuie să primești 200.

Indiciu

Un token expirat nu se repară; se înlocuiește.

Alte forme ale mesajului

  • 401 Unauthorized: token_expired
  • TokenExpiredError: jwt expired
  • {"message": "Token has expired"}

Cum o eviți pe viitor

  • Salvează la login și tokenExpira (Date.now() + expiresIn * 1000).
  • Pune un pre-request la nivel de colecție care face login când tokenul expiră în mai puțin de 30 de secunde.
  • În rulările lungi (Newman), reîmprospătarea automată e obligatorie.

Întrebări frecvente

Cum văd când expiră tokenul?

Decodează payload-ul (jwt.io sau atob pe a doua parte) și citește exp; e în secunde Unix.

E un bug dacă tokenul expiră?

Nu, e comportamentul dorit. Bug ar fi ca un token expirat să fie încă acceptat.

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.