...
← Curs ASP.NET Core: toate lecțiile
Lecția 2 · HTTP

HTTP pe înțeles: cereri și răspunsuri

Tot ce face un API se reduce la un dialog simplu: clientul trimite o cerere HTTP, serverul trimite înapoi un răspuns HTTP. În lecția aceasta afli din ce este făcută o cerere, din ce este făcut un răspuns și ce înseamnă codurile de status 200 și 404 pe care le-ai văzut deja în laborator.

Ce este HTTP

HTTP (HyperText Transfer Protocol) este „limba” în care vorbesc browserele, aplicațiile mobile și serverele. Când scrii o adresă în browser sau apeși „Adaugă în coș” într-o aplicație, în spate pleacă o cerere HTTP către un server.

HTTP este un protocol de tip cerere–răspuns: clientul întreabă, serverul răspunde. Serverul nu trimite nimic din proprie inițiativă; așteaptă cereri. Exact asta face app.Run(): pornește serverul și îl lasă să aștepte.

Ideea pe scurt

O cerere HTTP este o întrebare („dă-mi produsul 15”), iar un răspuns HTTP este rezultatul („iată produsul 15” sau „produsul 15 nu există”). Fiecare cerere primește exact un răspuns.

Din ce este făcută o cerere

O cerere HTTP are patru părți. Iată cum arată, ca text, o cerere trimisă de aplicația unui magazin online:

GET /produse/15 HTTP/1.1
Host: magazin.ro
Accept: application/json
User-Agent: MagazinApp/2.1
ParteExempluLa ce folosește
metodaGETce vrei să faci: să citești, să creezi, să modifici, să ștergi
calea/produse/15ce resursă te interesează
antetele (headers)Accept: application/jsoninformații suplimentare: ce format accepți, cine ești, limba
corpul (body)lipsește la GETdatele trimise, de exemplu formularul de înregistrare la POST

În laborator, fiecare linie de rezultat începe cu primele două părți ale cererii: metoda și calea, de exemplu GET /produse/15.

Metodele HTTP pe scurt

Metoda spune serverului ce acțiune vrei să faci. Le vei folosi pe toate în acest modul; deocamdată ajunge să le recunoști:

MetodaAcțiuneExemplu dintr-un magazin
GETcitește datevezi pagina unui produs
POSTcreează ceva nouplasezi o comandă
PUTînlocuiește (actualizează) ceva existentîți schimbi adresa de livrare
DELETEștergescoți un produs din coș

În ASP.NET Core, fiecare metodă are funcția ei: MapGet, MapPost, MapPut, MapDelete. Până acum ai folosit doar MapGet, care răspunde numai la cereri GET.

Din ce este făcut un răspuns

Răspunsul are trei părți: codul de status, antetele și corpul. Ca text, arată așa:

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8

pong
  • codul de status (200 OK) spune pe scurt cum a mers: un număr de trei cifre plus un text standard;
  • antetele descriu răspunsul, de exemplu Content-Type spune ce fel de date sunt în corp;
  • corpul conține datele propriu-zise: un text, un JSON sau nimic.

Codurile de status se împart în familii, după prima cifră:

FamilieÎnseamnăExemple
2xxsucces200 OK, 201 Created, 204 No Content
3xxredirecționare (resursa e în altă parte)301 Moved Permanently, 302 Found
4xxgreșeala clientului400 Bad Request, 401 Unauthorized, 404 Not Found
5xxgreșeala serverului500 Internal Server Error
Cine a greșit?

Un 4xx înseamnă că cererea are o problemă (adresă greșită, date lipsă), deci clientul trebuie să o corecteze. Un 5xx înseamnă că serverul a avut o problemă (de exemplu o excepție în codul tău); clientul nu poate face nimic în afară de a încerca mai târziu.

200 și 404 în laborator

Iată un server cu două endpoint-uri GET și trei cereri, ultima către o cale care nu există:

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

app.MapGet("/produse", () => "Laptop, Mouse, Tastatură");
app.MapGet("/cos", () => "Coșul tău are 2 produse");

app.Run();

// GET /produse
// GET /cos
// GET /comenzi
GET /produse → 200 OK
Laptop, Mouse, Tastatură
GET /cos → 200 OK
Coșul tău are 2 produse
GET /comenzi → 404 Not Found
1
GET /produse se potrivește cu primul MapGet: serverul răspunde cu 200 OK și textul din funcție.
2
GET /cos se potrivește cu al doilea MapGet: tot 200 OK.
3
GET /comenzi nu se potrivește cu niciun endpoint: ASP.NET Core răspunde singur cu 404 Not Found, fără corp. Codul tău nu a rulat deloc pentru această cerere.

Observă că nu ai scris nicăieri „404”. Framework-ul alege automat 404 când nicio rută nu se potrivește. Mai târziu vei întoarce tu coduri de status, de exemplu 404 când un produs cerut nu există în listă.

Exemple reale de cereri și răspunsuri

SituațiaCerereaRăspunsul
deschizi pagina unui produsGET /produse/15200 OK cu datele produsului
produsul a fost scos din magazinGET /produse/999404 Not Found
adaugi un produs în coșPOST /cos201 Created
te autentifici cu parola greșităPOST /login401 Unauthorized
serverul are o eroare în codorice cerere500 Internal Server Error
  • Confuzie frecventă: 404 nu înseamnă că serverul e oprit. Dacă serverul ar fi oprit, nu ai primi niciun răspuns. 404 este un răspuns normal: „am primit cererea, dar nu am ce îți da la adresa asta”.
  • Calea contează la literă: /ping și /pong sunt adrese diferite. O greșeală de tipar în cale duce la 404.
Exercițiul tău

Construiește un mic server de diagnostic cu două endpoint-uri GET: /ping răspunde cu textul pong, iar /versiune răspunde cu textul 1.0. Laboratorul trimite trei cereri: GET /ping, GET /versiune și GET /pong (pentru /pong nu definești nimic, deci răspunsul corect este 404).

  • Adaugă endpoint-ul GET /ping care întoarce pong.
  • Adaugă endpoint-ul GET /versiune care întoarce 1.0.
  • Nu adăuga nimic pentru /pong.
Ai nevoie de două apeluri app.MapGet("/cale", () => "text");, ambele înainte de app.Run();.

Soluția exercițiului

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

app.MapGet("/ping", () => "pong");
app.MapGet("/versiune", () => "1.0");

app.Run();
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 2 · HTTP pe înțeles: cereri și răspunsuri
Progres 0% 0 din 22
Lecția curentă 2 / 20 Http