Ce este ASP.NET Core și primul tău endpoint
Aplicațiile pe care le folosești zilnic (banca de pe telefon, magazinul online, aplicația de livrări) vorbesc în spate cu un server. În acest curs înveți să construiești chiar acel server, cu ASP.NET Core și C#. În prima lecție afli ce este un API, ce face ASP.NET Core și pornești primul tău server, care răspunde la o cerere HTTP.
Ce este un server web și ce este un API
Când deschizi aplicația unei bănci și vezi soldul, telefonul nu are soldul salvat în el. Aplicația trimite o cerere prin internet către un calculator al băncii (serverul), iar serverul trimite înapoi un răspuns cu datele cerute.
Un API (Application Programming Interface) este setul de adrese la care serverul răspunde și regulile prin care îi ceri ceva. De exemplu, aplicația de livrări poate cere GET /restaurante ca să primească lista restaurantelor și GET /comenzi/15 ca să afle unde e comanda ta.
- clientul (aplicația mobilă, site-ul, alt server) trimite o cerere;
- serverul (programul scris de tine) o primește, face ce trebuie (caută în baza de date, calculează) și trimite un răspuns;
- răspunsul conține de obicei date în format JSON, pe care clientul le afișează frumos.
Front-end-ul este ce vede utilizatorul. Back-end-ul este serverul care ține datele și regulile. În acest curs scrii back-end: API-uri web.
Ce este ASP.NET Core
ASP.NET Core este framework-ul Microsoft pentru aplicații web și API-uri în C#. Este gratuit, open source, rulează pe Windows, Linux și macOS și este unul dintre cele mai rapide framework-uri web din lume.
În România îl găsești în bănci, firme de asigurări, magazine online mari, companii de software și outsourcing. Când vezi un anunț pentru .NET Developer sau C# Backend Developer, aproape mereu este vorba despre ASP.NET Core.
| Termen | Ce înseamnă |
|---|---|
| C# | limbajul în care scrii codul (l-ai învățat în cursul de C#) |
| .NET | platforma care rulează programele C# |
| ASP.NET Core | partea din .NET pentru servere web și API-uri |
| endpoint | o adresă la care răspunde serverul, de exemplu GET /salut |
Cursul acesta presupune că știi bazele C#: variabile, metode, clase, interfețe, record, List, LINQ și async/await de bază. Nu le mai explicăm aici. Dacă ceva ți se pare nou, întoarce-te la lecția din cursul de C#.
Primul tău server, linie cu linie
Un proiect ASP.NET Core nou are un singur fișier important la început: Program.cs. Iată cel mai mic server posibil:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Salut, lume!");
app.Run();
// GET /GET / → 200 OK Salut, lume!
Rezultatul se citește așa: prima linie este cererea (GET /), după săgeată vine codul de status (200 OK înseamnă „totul a mers bine”), iar pe linia următoare este corpul răspunsului, adică textul întors de funcție.
Cum rulează în realitate și cum rulează aici
Pe calculatorul tău, un programator .NET creează proiectul și îl pornește din terminal:
dotnet new web -o Magazin cd Magazin dotnet run
Serverul pornește la o adresă ca http://localhost:5000, iar cererile le trimite din browser, din Postman sau dintr-un fișier .http. Nu trebuie să instalezi nimic din toate acestea acum.
În dreapta ai un laborator care face totul pentru tine: compilează Program.cs cu compilatorul C# real, pornește aplicația și îi trimite cererile HTTP. Pentru fiecare cerere vezi linia de status și corpul răspunsului.
Ca să încerci singur o adresă, scrie la finalul fișierului un comentariu de forma // GET /cale. Laboratorul trimite câte o cerere pentru fiecare astfel de comentariu, în ordine. La verificarea exercițiului, laboratorul trimite propriile cereri.
Mai multe endpoint-uri și o adresă care nu există
Poți avea oricâte endpoint-uri. Fiecare MapGet adaugă o adresă nouă. Ce se întâmplă dacă cineva cere o adresă pe care n-ai definit-o?
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Pagina principală");
app.MapGet("/contact", () => "Ne găsești în București");
app.Run();
// GET /
// GET /contact
// GET /despreGET / → 200 OK Pagina principală GET /contact → 200 OK Ne găsești în București GET /despre → 404 Not Found
Pentru /despre nu există niciun endpoint, așa că ASP.NET Core răspunde singur cu 404 Not Found și un corp gol. Este exact ce vezi pe un site când intri pe o pagină care nu există.
Dacă uiți app.Run();, programul se termină imediat după ce a definit endpoint-urile, iar serverul nu mai pornește. Nicio cerere nu primește răspuns. Pune mereu app.Run(); la finalul codului de pornire.
Greșeli frecvente la început
- Uiți ghilimelele din jurul adresei: MapGet(/salut, ...) nu compilează. Adresa este un string: "/salut".
- Uiți slash-ul de la început: scrie "/salut", nu "salut", ca să fie clar că este o cale de la rădăcina serverului.
- **Scrii endpoint-urile după app.Run()**: Run pornește serverul și nu se mai întoarce, așa că rutele de după el nu se înregistrează la timp.
- Confunzi 404 cu o eroare a programului: 404 înseamnă doar că adresa cerută nu există, serverul funcționează normal.
În lecțiile următoare înveți ce este HTTP mai exact (metode, coduri de status, antete) și cum să trimiți date JSON. Deocamdată, este suficient să știi să adaugi un endpoint care întoarce un text.
Construiește primul endpoint al Academiei: la adresa /salut, serverul trebuie să răspundă cu textul Bun venit la Academia Programatorilor!. Laboratorul trimite două cereri: GET /salut și GET / (pentru / nu definești nimic, deci răspunsul corect este 404).
- Adaugă un endpoint MapGet pentru adresa /salut.
- Funcția endpoint-ului întoarce exact textul Bun venit la Academia Programatorilor!.
- Nu adăuga un endpoint pentru /: cererea GET / trebuie să primească 404.
- Lasă app.Run(); la final.
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/salut", () => "Bun venit la Academia Programatorilor!");
app.Run(); 