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

"errors":{"X-Versiune":["The versiune field is required."]}

Pe scurt

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

Greșit
C#
[HttpGet]
public IActionResult Lista([FromHeader(Name = "X-Versiune")] string versiune) => ...
Corect
C#
[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

Greșit
C#
curl https://localhost:5001/api/produse
Corect
C#
curl -H "X-Versiune: 2" https://localhost:5001/api/produse

Când antetul e chiar obligatoriu, clientul trebuie să-l trimită.

Repară tu

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.

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();



[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}");
}
După reparație, programul afișează
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ă.

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

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