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.
| GET | POST | |
|---|---|---|
| scop | citește date | trimite date (de obicei creează ceva) |
| corp | nu are | are, de obicei JSON |
| parametrii | în cale și în query | în cale, query și corp |
| exemplu | GET /produse/15 | POST /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 /mesajePOST /mesaje → 200 OK Mesaj de la Ana: Bună, ce faci? GET /mesaje → 405 Method Not Allowed
Î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 /mesajePOST /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?
| Problema | Răspunsul | Ce înseamnă |
|---|---|---|
| corpul este text simplu, nu JSON | 415 Unsupported Media Type | serverul acceptă doar application/json pentru acest endpoint |
| corpul lipsește | 400 Bad Request | mesajul spune că parametrul mesaj trebuia citit din corp, dar corpul nu există |
| JSON stricat (de exemplu fără acolada de final) | 400 Bad Request | JSON-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 utilizatorului | Cererea | Corpul |
|---|---|---|
| se înregistrează | POST /utilizatori | {"email": "ana@exemplu.ro", "parola": "..."} |
| adaugă în coș | POST /cos/produse | {"produsId": 15, "cantitate": 2} |
| plasează o comandă | POST /comenzi | adresa, produsele, metoda de plată |
| trimite un mesaj | POST /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.
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}.
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); 