"errors":{"X-Versiune":["The versiune field is required."]}
Acțiunea citește un antet cu [FromHeader(Name = "X-Versiune")] string versiune, iar cererea nu l-a trimis. Parametrul non-nullable e obligatoriu, deci [ApiController] răspunde 400. Trimite antetul sau, dacă e opțional, declară parametrul string? și tratează lipsa lui.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Eroarea arată ciudat: cheia din errors e numele antetului (X-Versiune), dar mesajul folosește numele parametrului C# (The versiune field is required.). Asta pentru că binding-ul raportează eroarea sub numele sursei, iar validarea folosește numele parametrului.
Cauza este aceeași ca la câmpurile din corp: cu nullable reference types active, string versiune e obligatoriu. Antetele HTTP sunt deseori opționale (versiunea API, id-ul de corelare, limba), iar clienții vechi nu le trimit.
Dacă antetul e cu adevărat obligatoriu (o cheie de API), 400 e corect; poate fi mai potrivit chiar 401, printr-un middleware de autentificare. Dacă e opțional, string? plus o valoare implicită în cod rezolvă problema.
De ce apare: cauzele frecvente
1Antet opțional declarat non-nullable
[HttpGet]
public IActionResult Lista([FromHeader(Name = "X-Versiune")] string versiune) => ...[HttpGet]
public IActionResult Lista([FromHeader(Name = "X-Versiune")] string? versiune)
{
var v = versiune ?? "1";
...
}Cu string?, lipsa antetului e acceptată, iar codul alege valoarea implicită.
2Clientul nu trimite antetul obligatoriu
curl https://localhost:5001/api/produsecurl -H "X-Versiune: 2" https://localhost:5001/api/produseCând antetul e chiar obligatoriu, clientul trebuie să-l trimită.
Repară eroarea, direct în pagină
Aplicațiile mobile vechi nu trimit antetul X-Versiune, iar GET /api/produse le răspunde 400 (The versiune field is required.). Fă antetul opțional, cu versiunea implicită 1, ca ambele cereri să primească 200.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
// TODO: antetul trebuie să fie opțional, cu versiunea implicită 1
[HttpGet]
public IActionResult Lista([FromHeader(Name = "X-Versiune")] string versiune) =>
Ok($"Lista de produse, format v{versiune}");
}GET /api/produse → 200 OK Lista de produse, format v1 GET /api/produse → 200 OK Lista de produse, format v2
Indiciu
Un parametru string? acceptă lipsa antetului; ?? alege valoarea implicită.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
[HttpGet]
public IActionResult Lista([FromHeader(Name = "X-Versiune")] string? versiune) =>
Ok($"Lista de produse, format v{versiune ?? "1"}");
}De ce merge
Parametrul string versiune era obligatoriu din cauza nullable reference types. Cu string?, binding-ul acceptă lipsa antetului și pune null, iar versiune ?? "1" alege versiunea implicită. Clienții noi, care trimit antetul, primesc în continuare versiunea cerută. Lipsa unui antet opțional nu mai blochează clienții vechi.
Alte forme ale mesajului
The cheie field is required."errors":{"X-Api-Key":["The cheie field is required."]}
Cum o eviți pe viitor
- Decide pentru fiecare antet dacă e obligatoriu și reflectă asta în tip.
- Pentru chei de API, preferă un middleware sau o schemă de autentificare, care răspunde 401.
- Documentează antetele în OpenAPI.
- Când adaugi un antet nou într-un API folosit de aplicații existente, fă-l opțional la început, cu o valoare implicită.
Întrebări frecvente
De ce cheia e X-Versiune, iar mesajul spune versiune?
Cheia din errors e numele sub care s-a făcut binding-ul (numele antetului), iar mesajul de validare folosește numele parametrului din C#.
Antetele sunt sensibile la majuscule?
Nu. HTTP tratează numele antetelor fără să țină cont de majuscule, deci x-versiune funcționează la fel.
Erori înrudite
The Descriere field is required. Validarea a găsit o proprietate obligatorie fără valoare. Cu nullable reference types activate, orice string non-nullable (string Descriere) e tratat de controllere ca [Required]. Dacă proprietatea e opțională, declar-o string?; dacă e obligatorie, clientul trebuie să o trimită. {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cantitate":["The field Cantitate must be between 1 and 100."]}} Un controller cu [ApiController] a validat automat datele primite și a găsit erori, așa că a răspuns 400 cu ValidationProblemDetails înainte să ruleze acțiunea. Proprietatea errors spune, pentru fiecare câmp, ce regulă a picat. Corectează datele trimise sau regula greșită din model. Î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.
