...
Eroare Postman · Autentificare și tokenuri

{"error": "unsupported_grant_type"}

Pe scurt

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-credentials cu 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 deloc grant_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

Greșit
JavaScript
grant_type=pasword
Corect
JavaScript
grant_type=password

Valorile sunt fixe, definite de standard.

2Body JSON în loc de formular

Greșit
JavaScript
Body raw JSON: {"grant_type": "password", ...}
Corect
JavaScript
Body x-www-form-urlencoded: grant_type=password, ...

Endpointul de token citește câmpurile din formular.

3Grant dezactivat pentru client

Greșit
JavaScript
grant_type=password   # nepermis clientului
Corect
JavaScript
grant_type=client_credentials   # sau authorization_code

Serverul poate permite doar anumite grant-uri pentru fiecare client.

Repară tu

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.

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_type exact 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

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