...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

The value 'laptop-gaming' is not valid for id.

Pe scurt

Model binding-ul nu a putut converti textul din rută, query sau formular în tipul parametrului: ai cerut int, dar ai primit 'laptop-gaming'. Pune o constrângere de rută ({id:int}) ca valorile greșite să nu ajungă la acțiune, sau trimite valoarea în formatul corect.

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

Ce înseamnă

Mesajul apare în errors al unui răspuns 400 dintr-un controller [ApiController], sub numele parametrului sau al proprietății. Spune că valoarea primită ca text ('laptop-gaming') nu poate fi convertită în tipul cerut (int id, DateTime data, decimal pretMin, bool activ).

În rute, apare des când o rută fără constrângere ([HttpGet("{id}")]) primește altceva decât un număr: ruta se potrivește oricărui text, iar binding-ul pică. Cu o constrângere ({id:int}), un text nenumeric nu se mai potrivește cu ruta, deci poate ajunge la altă acțiune (de exemplu căutarea după slug) sau primește 404.

În query string, apare pentru ?pagina=doi sau ?pret=12,5 (separatorul zecimal acceptat depinde de cultura folosită de binding; în query se folosește cultura invariantă, cu punct).

De ce apare: cauzele frecvente

1Rută fără constrângere de tip

Greșit
C#
[HttpGet("{id}")]
public IActionResult DupaId(int id) => ...
// GET /api/produse/laptop-gaming -> 400
Corect
C#
[HttpGet("{id:int}")]
public IActionResult DupaId(int id) => ...

[HttpGet("{slug}")]
public IActionResult DupaSlug(string slug) => ...

Constrângerea :int face ca doar numerele să ajungă la DupaId; textul merge la DupaSlug.

2Număr cu virgulă în query

Greșit
C#
GET /api/produse?pretMin=12,5
Corect
C#
GET /api/produse?pretMin=12.5

Valorile din query și rută sunt convertite cu cultura invariantă, în care separatorul zecimal e punctul.

Repară tu

Repară eroarea, direct în pagină

GET /api/produse/laptop-gaming răspunde 400 (The value 'laptop-gaming' is not valid for id.), pentru că ruta {id} prinde orice text. Adaugă constrângerea :int pe ruta după id și o acțiune nouă [HttpGet("{slug}")] care caută produsul după slug, ca ambele cereri să primească 200.

Codul care dă eroarea
C#
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

public record Produs(int Id, string Slug, string Nume);

[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
    private static readonly List<Produs> produse = [new(1, "laptop-gaming", "Laptop de gaming"), new(2, "mouse-wireless", "Mouse wireless")];

    // TODO: doar numere aici
    [HttpGet("{id}")]
    public IActionResult DupaId(int id) =>
        produse.FirstOrDefault(p => p.Id == id) is Produs p ? Ok(p) : NotFound();

    // TODO: acțiune pentru căutarea după slug
}
După reparație, programul afișează
GET /api/produse/1 → 200 OK
{"id":1,"slug":"laptop-gaming","nume":"Laptop de gaming"}
GET /api/produse/laptop-gaming → 200 OK
{"id":1,"slug":"laptop-gaming","nume":"Laptop de gaming"}
Indiciu

Cu {id:int}, textul nu se mai potrivește cu prima rută și poate ajunge la a doua.

Alte forme ale mesajului

  • The value 'doi' is not valid for pagina.
  • The value 'abc' is not valid for PretMin.

Cum o eviți pe viitor

  • Pune constrângeri de tip pe parametrii de rută ({id:int}, {data:datetime}).
  • Documentează formatul parametrilor de query (punct zecimal, dată ISO).
  • Pentru valori text care pot lipsi, folosește tipuri nullable (int?).
  • Întoarce mesaje de eroare clare pentru parametrii de query, ca utilizatorii API-ului să știe formatul așteptat.

Întrebări frecvente

De ce cu {id:int} primesc 404, iar fără primesc 400?

Cu constrângere, ruta nu se potrivește deloc pentru un text, deci nu există endpoint: 404. Fără constrângere, ruta se potrivește, dar conversia parametrului pică: 400.

E diferit de „The value 'x' is invalid.”?

Da. „is not valid for X” apare când textul nu poate fi convertit în tip. „is invalid” apare când conversia a mers, dar valoarea nu e acceptată, de exemplu un număr care nu corespunde niciunei valori dintr-un enum.

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.