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

Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string cheie" was not provided from header.

Pe scurt

Un parametru marcat [FromHeader] e obligatoriu, iar cererea nu are antetul cu numele căutat. De obicei numele diferă: fără Name, se caută antetul cu numele parametrului C#. Folosește [FromHeader(Name = "X-Api-Key")] sau fă parametrul opțional (string?).

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

Ce înseamnă

[FromHeader] citește o valoare din antetele HTTP ale cererii. Fără Name, numele antetului căutat este chiar numele parametrului C# (cheie, apiKey), ceea ce aproape niciodată nu corespunde antetelor reale, care au forma X-Api-Key, X-Tenant-Id, Accept-Language. Când antetul lipsește și parametrul e obligatoriu (string fără ?, int fără valoare implicită), răspunsul e 400 cu mesajul de mai sus; în mesaj apare numele parametrului C#, nu al antetului.

Numele antetelor nu țin cont de majuscule. Alte cauze: un proxy sau CORS care elimină antetul, un client care îl trimite doar la unele cereri, sau un middleware care l-a citit și l-a scos. În controllerele cu [ApiController] aceeași situație produce un 400 de validare (The cheie field is required.).

De ce apare: cauzele frecvente

1Lipsește Name în atribut

Greșit
C#
app.MapGet("/rapoarte", ([FromHeader] string apiKey) => "ok");
// clientul trimite X-Api-Key: abc
Corect
C#
app.MapGet("/rapoarte", ([FromHeader(Name = "X-Api-Key")] string apiKey) => "ok");

Fără Name, binding-ul caută antetul apiKey, nu X-Api-Key.

2Antet opțional tratat ca obligatoriu

Greșit
C#
app.MapGet("/produse", ([FromHeader(Name = "Accept-Language")] string limba) => limba);
Corect
C#
app.MapGet("/produse", ([FromHeader(Name = "Accept-Language")] string? limba) => limba ?? "ro");

Antetele pe care nu le trimit toți clienții trebuie declarate nullable, cu o valoare implicită în cod.

Repară tu

Repară eroarea, direct în pagină

Clientul trimite antetul X-Api-Key: magazin-123, dar GET /rapoarte răspunde 400 cu Required parameter "string cheie" was not provided from header.. Repară legarea antetului ca răspunsul să fie Raport pentru cheia magazin-123.

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

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/rapoarte", ([FromHeader] string cheie) => $"Raport pentru cheia {cheie}");

app.Run();
După reparație, programul afișează
GET /rapoarte → 200 OK
Raport pentru cheia magazin-123
Indiciu

Atributul caută acum un antet cu numele parametrului C#.

Alte forme ale mesajului

  • Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int tenantId" was not provided from header.
  • Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int tenantId" from "abc".

Cum o eviți pe viitor

  • Scrie mereu Name la [FromHeader], cu numele exact al antetului.
  • Pentru chei API sau tenant, verifică antetul într-un middleware sau endpoint filter comun, nu în fiecare handler.
  • Declară nullable antetele opționale și dă-le o valoare implicită.
  • Testează endpoint-ul și cu, și fără antet.

Întrebări frecvente

Contează majusculele la numele antetului?

Nu. HTTP tratează numele antetelor fără să țină cont de majuscule, deci x-api-key și X-Api-Key sunt același antet.

De ce mesajul spune „string cheie” și nu numele antetului?

Mesajul descrie parametrul C# care nu a putut fi completat. Ca să afli ce antet se căuta, uită-te la atributul [FromHeader] al acelui parametru.

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.