415 Unsupported Media Type
Endpoint-ul așteaptă JSON, dar cererea a venit cu alt Content-Type (text/plain, form, XML sau fără antet). Trimite corpul cu Content-Type: application/json, de exemplu cu PostAsJsonAsync sau new StringContent(json, Encoding.UTF8, "application/json").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când un parametru se leagă din corp ca JSON, Minimal APIs (și controllerele cu [ApiController]) verifică întâi antetul Content-Type. Dacă nu e application/json sau un tip compatibil (de exemplu application/problem+json, orice +json), cererea nu e citită deloc și răspunsul este 415 Unsupported Media Type, cu corp gol. Conținutul în sine poate fi JSON perfect valid: contează doar antetul.
Cauze tipice: new StringContent(json) fără tipul media (implicit text/plain), un formular HTML trimis spre un endpoint JSON, Postman cu „Body: raw - Text” în loc de „JSON”, fetch fără antetul Content-Type, sau curl -d fără -H "Content-Type: application/json" (curl pune application/x-www-form-urlencoded). Tot 415 primești dacă un client trimite text/json către un endpoint Minimal API.
De ce apare: cauzele frecvente
1StringContent fără tip media în test sau client
var raspuns = await client.PostAsync("/produse", new StringContent(json));var raspuns = await client.PostAsync("/produse",
new StringContent(json, Encoding.UTF8, "application/json"));
// sau: await client.PostAsJsonAsync("/produse", produs);Fără al treilea argument, StringContent trimite text/plain; charset=utf-8.
2curl fără antet
curl -X POST http://localhost:5000/produse -d '{"nume":"Mouse"}'curl -X POST http://localhost:5000/produse -H "Content-Type: application/json" -d '{"nume":"Mouse"}'Cu -d, curl trimite implicit application/x-www-form-urlencoded.
3fetch din browser fără Content-Type
fetch("/produse", { method: "POST", body: JSON.stringify(produs) });fetch("/produse", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(produs)
});Un string trimis cu fetch are implicit text/plain;charset=UTF-8.
Repară eroarea, direct în pagină
API-ul de produse merge din Postman, dar testul de integrare Post_Creeaza_Produsul pică: Expected: Created, Actual: UnsupportedMediaType (415). Repară testul, fără să schimbi endpoint-ul, ca cererea să fie trimisă corect și testul să treacă.
using System.Net;
using System.Text;
using Microsoft.AspNetCore.Mvc.Testing;
using Xunit;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/produse", (Produs p) => Results.Created("/produse/1", p));
app.Run();
public record Produs(string Nume, decimal Pret);
public partial class Program { }
public class TesteProduse
{
[Fact]
public async Task Post_Creeaza_Produsul()
{
var client = new WebApplicationFactory<Program>().CreateClient();
var json = "{\"nume\":\"Mouse\",\"pret\":99}";
var raspuns = await client.PostAsync("/produse", new StringContent(json));
Assert.Equal(HttpStatusCode.Created, raspuns.StatusCode);
}
}Rulez testele... Passed TesteProduse.Post_Creeaza_Produsul Passed! - Failed: 0, Passed: 1, Skipped: 0, Total: 1
Indiciu
Uită-te ce Content-Type primește conținutul creat cu new StringContent(json).
Reparația
using System.Net;
using System.Text;
using Microsoft.AspNetCore.Mvc.Testing;
using Xunit;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/produse", (Produs p) => Results.Created("/produse/1", p));
app.Run();
public record Produs(string Nume, decimal Pret);
public partial class Program { }
public class TesteProduse
{
[Fact]
public async Task Post_Creeaza_Produsul()
{
var client = new WebApplicationFactory<Program>().CreateClient();
var json = "{\"nume\":\"Mouse\",\"pret\":99}";
var raspuns = await client.PostAsync("/produse", new StringContent(json, Encoding.UTF8, "application/json"));
Assert.Equal(HttpStatusCode.Created, raspuns.StatusCode);
}
}De ce merge
new StringContent(json) trimite corpul cu Content-Type: text/plain, iar endpoint-ul care leagă Produs din corp acceptă doar JSON, deci răspundea 415 fără să citească nimic. Cu new StringContent(json, Encoding.UTF8, "application/json") antetul e corect și cererea primește 201. Alternativ, client.PostAsJsonAsync("/produse", produs) serializează obiectul și setează antetul automat.
Alte forme ale mesajului
HTTP/1.1 415 Unsupported Media TypeExpected: Created, Actual: UnsupportedMediaType{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.16","title":"Unsupported Media Type","status":415}
Cum o eviți pe viitor
- În teste și în clienții .NET folosește
PostAsJsonAsync/PutAsJsonAsync: setează automat antetul. - În Postman alege „raw” + „JSON”; în
.httpscrieContent-Type: application/jsonsub cerere. - Când primești 415, verifică întâi antetul cererii, nu conținutul.
- În
fetch, pune mereu antetulContent-TypelângăJSON.stringify.
Întrebări frecvente
De ce 415 și nu 400, dacă JSON-ul e bun?
Pentru că serverul nici nu încearcă să citească JSON-ul: tipul declarat al conținutului nu e unul pe care îl acceptă endpoint-ul. 400 apare doar după ce începe citirea și JSON-ul e invalid.
Cum accept și formulare HTML pe același endpoint?
Nu poți lega același parametru din JSON și din formular. Fă un endpoint separat cu [FromForm], sau citește manual HttpRequest după Content-Type.
Erori înrudite
Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to read parameter "Produs p" from the request body as JSON. Corpul cererii nu a putut fi deserializat în tipul parametrului: JSON invalid, o valoare de alt tip (1.5 într-un int, text într-un număr) sau un tablou în loc de obiect. Corectează datele trimise sau tipul proprietății, astfel încât să corespundă. System.InvalidOperationException: Unable to read the request as JSON because the request content type 'text/plain; charset=utf-8' is not a known JSON content type. Ai apelat Request.ReadFromJsonAsync<T>() pe o cerere al cărei Content-Type nu e JSON. Metoda aruncă excepția (500), în loc de 415. Verifică întâi request.HasJsonContentType() și întoarce 415, sau lasă Minimal APIs să lege parametrul din corp. 405 Method Not Allowed Calea există, dar nu pentru metoda HTTP folosită: de exemplu există GET /produse, iar clientul trimite POST /produse. Adaugă endpoint-ul pentru metoda respectivă (MapPost, MapPut, MapDelete) sau corectează metoda din client. Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
