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

System.Text.Json.JsonException: The JSON value could not be converted to Stare. Path: $.stare | LineNumber: 0 | BytePositionInLine: 35.

Pe scurt

System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: cel mai des un enum trimis ca text ("Livrata") fără JsonStringEnumConverter, sau un text într-un număr. Adaugă convertorul pentru enum-uri sau corectează tipul. Path arată câmpul.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine din System.Text.Json și are trei părți utile: tipul țintă (Stare), calea câmpului în JSON ($.stare) și poziția în text. În ASP.NET Core îl vezi ca excepție interioară a lui „Failed to read parameter ... from the request body as JSON” (400), pe pagina de dezvoltator sau în loguri.

Cazul clasic sunt enum-urile: implicit, System.Text.Json le scrie și le citește ca numere ("stare": 1). Un client care trimite "stare": "Livrata" primește eroarea până adaugi JsonStringEnumConverter în opțiunile JSON ale aplicației (ConfigureHttpJsonOptions pentru Minimal APIs, AddJsonOptions pentru controllere). Alte cauze: "pret": "abc", un obiect unde se aștepta un număr, null pentru un tip valoare non-nullable (int, DateTime), sau o dată în format nerecunoscut.

De ce apare: cauzele frecvente

1Enum trimis ca text fără convertor

Greșit
C#
// corp: {"produs":"Mouse","stare":"Livrata"}
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
Corect
C#
var builder = WebApplication.CreateBuilder(args);
builder.Services.ConfigureHttpJsonOptions(o =>
    o.SerializerOptions.Converters.Add(new JsonStringEnumConverter()));
var app = builder.Build();

Convertorul citește și scrie enum-urile după nume (fără să conteze majusculele la citire).

2null pentru un tip valoare

Greșit
C#
public record Comanda(string Produs, int Cantitate);
// corp: {"produs":"Mouse","cantitate":null}
Corect
C#
public record Comanda(string Produs, int? Cantitate);

int nu poate fi null; dacă valoarea e opțională, tipul trebuie să fie int?.

3Dată în format local

Greșit
C#
// corp: {"data":"31.12.2026"}
public record Rezervare(DateOnly Data);
Corect
C#
// corp: {"data":"2026-12-31"}
public record Rezervare(DateOnly Data);

System.Text.Json citește datele doar în format ISO 8601.

Repară tu

Repară eroarea, direct în pagină

Aplicația de curierat trimite {"produs":"Mouse","stare":"Livrata"} la POST /livrari, iar API-ul răspunde 400 (în spate: The JSON value could not be converted to Stare. Path: $.stare). Configurează aplicația ca stările să circule ca text, în cereri și în răspunsuri.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapPost("/livrari", (Livrare livrare) => livrare);

app.Run();

public enum Stare { InDepozit, InTranzit, Livrata }
public record Livrare(string Produs, Stare Stare);
După reparație, programul afișează
POST /livrari → 200 OK
{"produs":"Mouse","stare":"Livrata"}
POST /livrari → 200 OK
{"produs":"Laptop","stare":"InTranzit"}
Indiciu

Opțiunile JSON ale Minimal APIs au o listă de convertoare.

Alte forme ale mesajului

  • System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.cantitate | LineNumber: 0 | BytePositionInLine: 31.
  • System.Text.Json.JsonException: The JSON value could not be converted to System.DateOnly. Path: $.data | LineNumber: 0 | BytePositionInLine: 20.
  • System.Text.Json.JsonException: The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 27.

Cum o eviți pe viitor

  • Decide de la început cum circulă enum-urile în API (recomandat: ca text, cu JsonStringEnumConverter) și configurează-l global.
  • Folosește tipuri nullable pentru câmpurile opționale.
  • Datele: doar ISO 8601 în JSON.
  • Citește Path din mesaj: îți arată exact câmpul.

Întrebări frecvente

Dacă adaug convertorul, răspunsurile se schimbă?

Da: enum-urile din răspunsuri vor fi scrise ca text ("Livrata") în loc de numere. Pentru clienții existenți care așteaptă numere, e o schimbare de contract.

Pot pune convertorul doar pe un enum?

Da, cu atributul [JsonConverter(typeof(JsonStringEnumConverter<Stare>))] pe tipul enum (.NET 8+) sau [JsonConverter(typeof(JsonStringEnumConverter))] pe proprietate.

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.