...
Eroare ASP.NET Core · Model binding, JSON, 400 și 415

415 Unsupported Media Type

Pe scurt

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

Greșit
C#
var raspuns = await client.PostAsync("/produse", new StringContent(json));
Corect
C#
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

Greșit
C#
curl -X POST http://localhost:5000/produse -d '{"nume":"Mouse"}'
Corect
C#
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

Greșit
C#
fetch("/produse", { method: "POST", body: JSON.stringify(produs) });
Corect
C#
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ă tu

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

Codul care dă eroarea
C#
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);
    }
}
După reparație, programul afișează
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).

Alte forme ale mesajului

  • HTTP/1.1 415 Unsupported Media Type
  • Expected: 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 .http scrie Content-Type: application/json sub cerere.
  • Când primești 415, verifică întâi antetul cererii, nu conținutul.
  • În fetch, pune mereu antetul Content-Type lâ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

← Toate erorile ASP.NET Core

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ță 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.