{"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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
unsupported_grant_type e o eroare standard OAuth 2.0: serverul nu știe (sau nu permite) tipul de grant cerut. Cauze practice:
- o greșeală de tipar:
pasword,client-credentialscu cratimă în loc de underscore; - body în format greșit: specificația cere
application/x-www-form-urlencoded. Dacă trimiți JSON, multe servere nu găsesc delocgrant_typeși răspund cu această eroare (altele răspund 415); - grant-ul e corect, dar nu e activat pentru clientul tău (de exemplu password grant dezactivat, cum recomandă OAuth 2.1).
Cu asistentul OAuth 2.0 din Postman, grant type-ul se alege dintr-o listă și formatul e corect automat. Eroarea apare mai ales când construiești cererea de token manual.
De ce apare: cauzele frecvente
1Grant scris greșit
grant_type=paswordgrant_type=passwordValorile sunt fixe, definite de standard.
2Body JSON în loc de formular
Body raw JSON: {"grant_type": "password", ...}Body x-www-form-urlencoded: grant_type=password, ...Endpointul de token citește câmpurile din formular.
3Grant dezactivat pentru client
grant_type=password # nepermis clientuluigrant_type=client_credentials # sau authorization_codeServerul poate permite doar anumite grant-uri pentru fiecare client.
Repară eroarea, direct în pagină
Cererea „Token OAuth” trimite grant_type=pasword (scris greșit) și primește 400 unsupported_grant_type. Corectează valoarea în password, salvează cererea și trimite-o: trebuie să primești 200 cu access_token.
Indiciu
Valoarea grant-ului e un cuvânt fix din standard.
Reparația
Body x-www-form-urlencoded: grant_type = password.
De ce merge
Serverul compară grant_type cu lista de grant-uri suportate; pasword nu e în listă. Cu valoarea corectă, serverul trece la verificarea credențialelor și emite tokenul. Serverul OAuth acceptă doar anumite tipuri de grant, scrise exact. Cu valoarea documentată, recunoaște fluxul și emite tokenul.
Alte forme ale mesajului
{"error": "unsupported_grant_type", "error_description": "grant_type trebuie să fie password"}OAuth2: Unsupported grant type
Cum o eviți pe viitor
- Folosește asistentul OAuth 2.0 din Postman când e posibil.
- La cereri manuale de token, folosește mereu x-www-form-urlencoded.
- Copiază numele grant-ului din documentația serverului de autorizare.
- Copiază valoarea
grant_typeexact din documentația serverului OAuth. - Trimite parametrii OAuth ca
x-www-form-urlencoded, cum cere standardul.
Întrebări frecvente
Ce grant-uri există?
Cele standard: authorization_code, client_credentials, refresh_token, password (depreciat) și device_code.
De ce merge cu asistentul și nu manual?
Asistentul trimite automat formatul și câmpurile corecte; manual e ușor să greșești formatul body-ului.
Erori înrudite
{"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. 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. 400 Bad Request Serverul a primit cererea, dar o consideră greșit formată: un parametru invalid, JSON stricat, un câmp de tip greșit. Citește body-ul răspunsului (de obicei spune exact ce parametru e greșit) și corectează cererea. Î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.
