{"error": "invalid_grant"}
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_uridiferă 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
grant_type=password
username=ana@magazin.test
password=Parola123grant_type=password
username=ana@magazin.test
password=Parola123!Credențialele trebuie să fie exacte.
2Cod de autorizare refolosit
POST /token code=abc123 # a doua oară# reia fluxul: Get New Access TokenCodurile de autorizare sunt de unică folosință.
3redirect_uri diferit
redirect_uri=https://app.test/cb/redirect_uri=https://app.test/cbValoarea trebuie să fie identică celei din cererea de autorizare.
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 !.
Reparația
Body x-www-form-urlencoded:
grant_type = password
username = ana@magazin.test
password = Parola123!De ce merge
Serverul OAuth verifică utilizatorul și parola înainte să emită tokenul; cu o literă lipsă, „grant-ul” (dovada) e invalid. Cu parola exactă, primești access_token, token_type și expires_in. invalid_grant spune că datele de autorizare au fost respinse: parolă greșită, cod expirat sau refresh token revocat. Cu date valide, serverul emite un token nou.
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
{"error": "unsupported_grant_type"} Endpointul de token nu recunoaște valoarea grant_type trimisă: e scrisă greșit, lipsește sau body-ul nu e x-www-form-urlencoded (serverul nu poate citi câmpurile din JSON). Trimite grant_type exact (password, client_credentials, authorization_code, refresh_token) ca form-urlencoded. 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. 415 Unsupported Media Type Serverul nu acceptă formatul body-ului trimis, de obicei pentru că antetul Content-Type nu e cel așteptat: body raw lăsat pe Text în loc de JSON, form-data în loc de JSON sau JSON în loc de x-www-form-urlencoded. Alege tipul corect de body în Postman. Î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.
