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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
415 privește formatul, nu conținutul. Serverul se uită la antetul Content-Type și refuză dacă nu știe să citească acel format.
În Postman, Content-Type e setat automat după tipul de body ales:
- raw JSON →
application/json; - raw Text →
text/plain; - form-data →
multipart/form-data; boundary=...; - x-www-form-urlencoded →
application/x-www-form-urlencoded.
Cea mai frecventă greșeală: scrii un JSON corect în body-ul raw, dar dropdown-ul a rămas pe Text, deci serverul primește text/plain. A doua: un antet Content-Type scris de mână în Headers, care suprascrie alegerea automată. A treia, invers: un endpoint OAuth (/token) care cere form-urlencoded, iar tu trimiți JSON.
De ce apare: cauzele frecvente
1Body raw pe Text
Body: raw, Text
{"email": "radu@exemplu.test", ...}Body: raw, JSON
{"email": "radu@exemplu.test", ...}Tipul JSON trimite antetul application/json.
2Content-Type scris manual
Headers: Content-Type: text/plainHeaders: (fără Content-Type manual)Antetul manual câștigă în fața celui automat.
3JSON spre un endpoint de formular
POST /auth/token
Body: raw JSONPOST /auth/token
Body: x-www-form-urlencodedEndpointurile OAuth cer de obicei form-urlencoded.
Repară eroarea, direct în pagină
Cererea „Înregistrare” are un JSON corect în body, dar tipul body-ului raw a rămas Text, deci serverul răspunde 415. Schimbă tipul în JSON, salvează cererea și trimite-o: trebuie să primești 201.
Indiciu
Dropdown-ul din dreapta opțiunilor raw.
Reparația
Body → raw → JSON (în loc de Text). Salvează și trimite.
De ce merge
Cu tipul JSON, Postman trimite Content-Type: application/json, formatul pe care serverul îl citește. Conținutul body-ului nu s-a schimbat; s-a schimbat doar eticheta care îi spune serverului cum să-l interpreteze. Serverul acceptă doar anumite formate de body și citește tipul din antetul Content-Type. Cu formatul corect, îl poate interpreta și ajunge la validarea câmpurilor.
Alte forme ale mesajului
415 Unsupported Media Type: Trimite corpul cererii ca application/json.HTTP 415Content type 'text/plain;charset=UTF-8' not supported
Cum o eviți pe viitor
- Verifică dropdown-ul de lângă body-ul raw de fiecare dată când creezi o cerere.
- Nu scrie manual
Content-Typedecât dacă ai un motiv clar. - Citește în documentație ce format cere fiecare endpoint.
- Alege tipul body-ului (raw JSON, form-data, urlencoded) după documentație, nu după obișnuință.
Întrebări frecvente
De ce JSON-ul arată bine și tot primesc 415?
Conținutul e corect, dar eticheta (Content-Type) spune altceva. Serverul se uită la etichetă.
Ce diferență e între 415 și 400?
415: formatul nu e acceptat. 400: formatul e acceptat, dar cererea e greșită.
Erori înrudite
400 Bad Request: Expected double-quoted property name in JSON at position 55 Body-ul trimis nu e JSON valid, iar parserul serverului s-a oprit la poziția indicată: de obicei o virgulă la final, ghilimele simple, chei fără ghilimele sau un comentariu. Corectează JSON-ul (editorul Postman subliniază greșeala) și trimite din nou. {"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. Î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.
