...
Eroare Postman · Autentificare și tokenuri

{"error": "invalid_grant"}

Pe scurt

Serverul OAuth a respins credențialele sau codul trimis la endpointul de token: utilizator ori parolă greșite (password grant), cod de autorizare expirat sau deja folosit, refresh token revocat. Verifică valorile trimise în body și obține un cod sau un token nou.

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

Ce înseamnă

invalid_grant e o eroare standard OAuth 2.0 (RFC 6749), întoarsă de endpointul /token, de obicei cu status 400 (unele servere folosesc 401). Înseamnă că „dovada” prezentată pentru obținerea tokenului nu e validă:

  • la password grant: utilizatorul sau parola sunt greșite;
  • la authorization code: codul a expirat (durează de obicei câteva minute), a fost deja folosit o dată sau redirect_uri diferă de cel din cererea inițială;
  • la refresh_token: tokenul a expirat, a fost revocat sau a fost deja rotit.

Body-ul poate avea și error_description cu detalii. În Postman, când folosești asistentul OAuth 2.0 („Get New Access Token”), eroarea apare în fereastra de autentificare și în Console. Dacă faci cererea manual, verifici body-ul form-urlencoded câmp cu câmp.

De ce apare: cauzele frecvente

1Parolă greșită la password grant

Greșit
JavaScript
grant_type=password
username=ana@magazin.test
password=Parola123
Corect
JavaScript
grant_type=password
username=ana@magazin.test
password=Parola123!

Credențialele trebuie să fie exacte.

2Cod de autorizare refolosit

Greșit
JavaScript
POST /token code=abc123   # a doua oară
Corect
JavaScript
# reia fluxul: Get New Access Token

Codurile de autorizare sunt de unică folosință.

3redirect_uri diferit

Greșit
JavaScript
redirect_uri=https://app.test/cb/
Corect
JavaScript
redirect_uri=https://app.test/cb

Valoarea trebuie să fie identică celei din cererea de autorizare.

Repară tu

Repară eroarea, direct în pagină

Cererea „Token OAuth” (POST {{baseUrl}}/auth/token, body x-www-form-urlencoded) trimite parola Parola123, fără semnul de exclamare, și primește 401 invalid_grant. Corectează câmpul password în Parola123!, salvează cererea și trimite-o: trebuie să primești 200 cu access_token.

Indiciu

Parola corectă a Anei se termină cu !.

Alte forme ale mesajului

  • {"error": "invalid_grant", "error_description": "Invalid user credentials"}
  • invalid_grant: Code not valid

Cum o eviți pe viitor

  • Ține credențialele OAuth în variabile, nu în body-uri scrise de mână.
  • Nu refolosi coduri de autorizare; obține unul nou la fiecare flux.
  • Testează explicit credențialele greșite: răspunsul așteptat e invalid_grant.
  • Verifică separat utilizatorul, parola și tipul de grant când primești invalid_grant.

Întrebări frecvente

De ce primesc 400 și nu 401?

Specificația OAuth folosește 400 pentru erorile de la endpointul de token; unele servere aleg 401.

Ce diferență e față de invalid_client?

invalid_client: aplicația (client_id/secret) nu e recunoscută. invalid_grant: utilizatorul, codul sau refresh tokenul nu sunt valide.

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.