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.
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
| Parte | Exemplu | La ce folosește |
|---|---|---|
| metoda | GET | ce vrei să faci: să citești, să creezi, să modifici, să ștergi |
| calea | /produse/15 | ce resursă te interesează |
| antetele (headers) | Accept: application/json | informații suplimentare: ce format accepți, cine ești, limba |
| corpul (body) | lipsește la GET | datele 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:
| Metoda | Acțiune | Exemplu dintr-un magazin |
|---|---|---|
| GET | citește date | vezi pagina unui produs |
| POST | creează ceva nou | plasezi o comandă |
| PUT | înlocuiește (actualizează) ceva existent | îți schimbi adresa de livrare |
| DELETE | șterge | scoț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 |
|---|---|---|
| 2xx | succes | 200 OK, 201 Created, 204 No Content |
| 3xx | redirecționare (resursa e în altă parte) | 301 Moved Permanently, 302 Found |
| 4xx | greșeala clientului | 400 Bad Request, 401 Unauthorized, 404 Not Found |
| 5xx | greșeala serverului | 500 Internal Server Error |
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 /comenziGET /produse → 200 OK Laptop, Mouse, Tastatură GET /cos → 200 OK Coșul tău are 2 produse GET /comenzi → 404 Not Found
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ția | Cererea | Răspunsul |
|---|---|---|
| deschizi pagina unui produs | GET /produse/15 | 200 OK cu datele produsului |
| produsul a fost scos din magazin | GET /produse/999 | 404 Not Found |
| adaugi un produs în coș | POST /cos | 201 Created |
| te autentifici cu parola greșită | POST /login | 401 Unauthorized |
| serverul are o eroare în cod | orice cerere | 500 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.
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.
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/ping", () => "pong");
app.MapGet("/versiune", () => "1.0");
app.Run(); 