...
← Curs ASP.NET Core: toate lecțiile
Lecția 13 · POST

MapPost: primești date în corpul cererii

Până acum clientul doar a cerut date. Dar un API trebuie să și primească: formularul de înregistrare, produsul adăugat în coș, mesajul trimis pe chat. Datele acestea nu încap în adresă; vin în corpul cererii, ca JSON, printr-o cerere POST. În lecția aceasta scrii primul tău endpoint MapPost.

POST: cererea care trimite date

O cerere GET cere date și nu are corp. O cerere POST trimite date serverului, în corp. Iată cum arată, ca text, cererea pe care o trimite o aplicație de chat când apeși „Trimite”:

POST /mesaje HTTP/1.1
Host: chat.ro
Content-Type: application/json

{"autor": "Ana", "text": "Bună, ce faci?"}
  • metoda este POST, calea /mesaje;
  • antetul Content-Type: application/json spune serverului că în corp este JSON;
  • după o linie goală vine corpul: obiectul JSON cu datele mesajului.
GETPOST
scopcitește datetrimite date (de obicei creează ceva)
corpnu areare, de obicei JSON
parametriiîn cale și în queryîn cale, query și corp
exempluGET /produse/15POST /comenzi cu detaliile comenzii

Primul MapPost

app.MapPost funcționează exact ca MapGet, dar răspunde doar la cereri POST. Diferența importantă este parametrul: un tip complex (un record) este citit automat din corpul JSON.

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

app.MapPost("/mesaje", (Mesaj mesaj) => $"Mesaj de la {mesaj.Autor}: {mesaj.Text}");

app.Run();

record Mesaj(string Autor, string Text);

// POST /mesaje {"autor": "Ana", "text": "Bună, ce faci?"}
// GET /mesaje
POST /mesaje → 200 OK
Mesaj de la Ana: Bună, ce faci?
GET /mesaje → 405 Method Not Allowed
1
Cererea POST /mesaje are în corp JSON-ul {"autor": ..., "text": ...}.
2
ASP.NET Core vede parametrul Mesaj mesaj: tipul nu este simplu (ca int sau string), deci îl caută în corp.
3
Deserializează JSON-ul într-un obiect Mesaj: autor → Autor, text → Text. Literele mari și mici din numele cheilor nu contează.
4
Endpoint-ul rulează cu obiectul gata construit.
5
GET /mesaje primește 405 Method Not Allowed: calea există, dar doar pentru POST.
Comentariile din laborator

Într-un comentariu de test, corpul JSON se scrie după cale: // POST /mesaje {"autor": "Ana", "text": "Salut"}. Laboratorul îl trimite cu Content-Type: application/json, ca Postman sau o aplicație reală.

Ce se întâmplă când corpul e greșit

Endpoint-ul tău rulează doar dacă ASP.NET Core a reușit să construiască obiectul. Altfel, framework-ul răspunde singur:

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

app.MapPost("/mesaje", (Mesaj mesaj) => $"Mesaj de la {mesaj.Autor}: {mesaj.Text}");

app.Run();

record Mesaj(string Autor, string Text);

// POST /mesaje Salut, sunt Ana
// POST /mesaje
POST /mesaje → 415 Unsupported Media Type
POST /mesaje → 400 Bad Request
Microsoft.AspNetCore.Http.BadHttpRequestException: Implicit body inferred for parameter "mesaj" but no body was provided. Did you mean to use a Service instead?
ProblemaRăspunsulCe înseamnă
corpul este text simplu, nu JSON415 Unsupported Media Typeserverul acceptă doar application/json pentru acest endpoint
corpul lipsește400 Bad Requestmesajul spune că parametrul mesaj trebuia citit din corp, dar corpul nu există
JSON stricat (de exemplu fără acolada de final)400 Bad RequestJSON-ul nu poate fi citit

Mesajul Implicit body inferred for parameter "mesaj" but no body was provided înseamnă: „am dedus că parametrul mesaj vine din corp, dar nu ai trimis niciun corp”. Partea Did you mean to use a Service instead? este o sugestie pentru alt caz (servicii, pe care le înveți mai târziu).

Câmpuri lipsă: nimeni nu verifică în locul tău

Dacă JSON-ul e valid, dar îi lipsește o cheie, obiectul se construiește oricum, iar proprietatea lipsă rămâne null:

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

app.MapPost("/mesaje", (Mesaj mesaj) => $"Autor: {mesaj.Autor}, text: [{mesaj.Text}]");

app.Run();

record Mesaj(string Autor, string Text);

// POST /mesaje {"autor": "Ana"}
POST /mesaje → 200 OK
Autor: Ana, text: []

Endpoint-ul a rulat, iar Text este null (interpolarea l-a afișat ca text gol). Minimal APIs nu validează automat datele primite. Verificările (de exemplu „textul nu poate fi gol”) le scrii tu, cu Results.BadRequest, ca în lecția trecută; mai târziu în curs vei învăța și validarea cu atribute.

Greșeli frecvente

  • Trimiți GET la un endpoint POST: răspunsul este 405 Method Not Allowed. Verifică metoda în Postman sau în fișierul .http.
  • **Uiți antetul Content-Type: application/json** când testezi cu un instrument: serverul răspunde 415.
  • Două tipuri complexe în același endpoint: o cerere are un singur corp, deci un endpoint poate avea un singur parametru citit din corp.
  • Te bazezi pe faptul că toate câmpurile vin: un câmp lipsă ajunge null; verifică-l înainte să-l folosești.

POST în aplicații reale

Acțiunea utilizatoruluiCerereaCorpul
se înregistreazăPOST /utilizatori{"email": "ana@exemplu.ro", "parola": "..."}
adaugă în coșPOST /cos/produse{"produsId": 15, "cantitate": 2}
plasează o comandăPOST /comenziadresa, produsele, metoda de plată
trimite un mesajPOST /mesaje{"autor": "Ana", "text": "Salut"}

În realitate testezi un endpoint POST cu Postman, cu curl din terminal sau cu un fișier .http în Visual Studio / Rider, unde scrii metoda, adresa, antetul Content-Type și corpul. Laboratorul face același lucru pentru tine.

Exercițiul tău

Construiește endpoint-ul prin care aplicația de chat trimite mesaje. Declară record Mesaj(string Autor, string Text) și adaugă POST /mesaje, care primește mesajul din corp și răspunde cu Mesaj de la {Autor}: {Text}. Laboratorul trimite un POST cu JSON-ul {"autor": "Ana", "text": "Salut!"} și un POST cu un corp text simplu (care trebuie să primească 415).

  • Declară record Mesaj(string Autor, string Text); după app.Run();.
  • Adaugă app.MapPost("/mesaje", (Mesaj mesaj) => ...).
  • Întoarce textul Mesaj de la {mesaj.Autor}: {mesaj.Text}.
Parametrul de tip record este citit automat din corpul JSON; nu ai nevoie de nimic în plus.

Soluția exercițiului

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

app.MapPost("/mesaje", (Mesaj mesaj) => $"Mesaj de la {mesaj.Autor}: {mesaj.Text}");

app.Run();

record Mesaj(string Autor, string Text);
Excelent! Continuă cu lecția următoare →
Program.csASP.NET Core
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primul tău API cu ASP.NET Core Lecția 13 · MapPost: primești date în corpul cererii
Progres 0% 0 din 22
Lecția curentă 13 / 20 Post