Mini-proiect: lista de cumpărături
E timpul să pui cap la cap tot ce ai învățat: rute, parametri, record-uri, o listă în memorie, Results.Ok, NotFound, BadRequest și Created. Construiești API-ul unei aplicații de listă de cumpărături, pas cu pas, exact cum ai face într-un proiect real: întâi modelul de date, apoi citirea, apoi adăugarea cu validare.
Ce construiești
Aplicația de pe telefon afișează lista de cumpărături a familiei și permite adăugarea de articole. Ea are nevoie de trei endpoint-uri:
| Cererea | Ce face | Răspunsuri posibile |
|---|---|---|
| GET /articole | întoarce toată lista | 200 |
| GET /articole/{id} | întoarce un articol | 200 sau 404 |
| POST /articole | adaugă un articol | 201 + Location sau 400 |
Înainte de cod, un programator bun scrie un astfel de tabel: el este contractul API-ului, pe care îl discuți cu echipa care face aplicația mobilă.
Pasul 1: modelul de date
Ai nevoie de două record-uri: articolul complet (cu id) și ce trimite clientul la adăugare (fără id). Lista pornește cu două articole:
record Articol(int Id, string Nume, int Cantitate); record ArticolNou(string Nume, int Cantitate);
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var articole = new List<Articol>
{
new(1, "Ouă", 10),
new(2, "Mere", 3)
};
app.MapGet("/articole", () => articole);
app.Run();
record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);
// GET /articoleGET /articole → 200 OK
[{"id":1,"nume":"Ouă","cantitate":10},{"id":2,"nume":"Mere","cantitate":3}]Pasul 2: citirea unui articol
Endpoint-ul după id folosește constrângerea int, FirstOrDefault și ternarul din lecția despre Results:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var articole = new List<Articol>
{
new(1, "Ouă", 10),
new(2, "Mere", 3)
};
app.MapGet("/articole", () => articole);
app.MapGet("/articole/{id:int}", (int id) =>
{
var articol = articole.FirstOrDefault(a => a.Id == id);
return articol is null ? Results.NotFound($"Articolul {id} nu există") : Results.Ok(articol);
});
app.Run();
record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);
// GET /articole/2
// GET /articole/7GET /articole/2 → 200 OK
{"id":2,"nume":"Mere","cantitate":3}
GET /articole/7 → 404 Not Found
"Articolul 7 nu există"Pasul 3: adăugarea, cu validare
La adăugare apare o regulă de business: nu are sens să cumperi 0 sau -2 ouă. Verifici regula înainte de a modifica lista; dacă nu e respectată, răspunzi 400 și nu salvezi nimic.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var articole = new List<Articol>
{
new(1, "Ouă", 10),
new(2, "Mere", 3)
};
app.MapGet("/articole", () => articole);
app.MapPost("/articole", (ArticolNou nou) =>
{
if (nou.Cantitate <= 0)
{
return Results.BadRequest("Cantitatea trebuie să fie pozitivă");
}
var id = articole.Max(a => a.Id) + 1;
var articol = new Articol(id, nou.Nume, nou.Cantitate);
articole.Add(articol);
return Results.Created($"/articole/{id}", articol);
});
app.Run();
record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);
// POST /articole {"nume": "Brânză", "cantitate": 1}
// POST /articole {"nume": "Roșii", "cantitate": -2}
// GET /articolePOST /articole → 201 Created
Location: /articole/3
{"id":3,"nume":"Brânză","cantitate":1}
POST /articole → 400 Bad Request
"Cantitatea trebuie să fie pozitivă"
GET /articole → 200 OK
[{"id":1,"nume":"Ouă","cantitate":10},{"id":2,"nume":"Mere","cantitate":3},{"id":3,"nume":"Brânză","cantitate":1}]Regula „verifică, apoi modifică” te ferește de date stricate. Dacă ai adăuga întâi articolul și ai verifica după, un articol invalid ar rămâne în listă chiar dacă răspunsul a fost 400.
Cum l-ai testa în realitate
Într-un proiect real ai porni serverul cu dotnet run și ai trimite cererile dintr-un fișier articole.http (Visual Studio, Rider și VS Code îl pot rula, cu butoane „Send Request” deasupra fiecărei cereri):
### Toată lista
GET http://localhost:5000/articole
### Adaugă un articol
POST http://localhost:5000/articole
Content-Type: application/json
{ "nume": "Lapte", "cantitate": 2 }În laborator, cererile din exercițiu sunt trimise automat, în ordine, iar tu vezi fiecare răspuns.
Recapitulare înainte de exercițiu
| Concept | Unde îl folosești aici |
|---|---|
| record | Articol și ArticolNou |
| listă în memorie | articole, creată o dată, înainte de rute |
| constrângere {id:int} | GET /articole/{id:int} |
| Results.Ok / NotFound | articol găsit / lipsă |
| Results.BadRequest | cantitate zero sau negativă |
| Results.Created | articol adăugat, cu Location |
Construiește singur API-ul listei de cumpărături. Lista pornește cu (1, Ouă, 10) și (2, Mere, 3). Ai nevoie de: GET /articole (toată lista), GET /articole/{id:int} (200 cu articolul sau 404 cu mesajul Articolul {id} nu există) și POST /articole (400 cu mesajul Cantitatea trebuie să fie pozitivă dacă Cantitate <= 0, altfel 201 cu Location: /articole/{id}, id = cel mai mare + 1). Laboratorul trimite: GET /articole, POST cu Lapte 2, POST cu Pâine 0, GET /articole/3, GET /articole/99.
- Adaugă GET /articole care întoarce lista.
- Adaugă GET /articole/{id:int} cu Results.Ok și Results.NotFound($"Articolul {id} nu există").
- Adaugă POST /articole: întâi validarea cu Results.BadRequest("Cantitatea trebuie să fie pozitivă"), apoi id nou, Add și Results.Created.
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var articole = new List<Articol>
{
new(1, "Ouă", 10),
new(2, "Mere", 3)
};
app.MapGet("/articole", () => articole);
app.MapGet("/articole/{id:int}", (int id) =>
{
var articol = articole.FirstOrDefault(a => a.Id == id);
return articol is null ? Results.NotFound($"Articolul {id} nu există") : Results.Ok(articol);
});
app.MapPost("/articole", (ArticolNou nou) =>
{
if (nou.Cantitate <= 0)
{
return Results.BadRequest("Cantitatea trebuie să fie pozitivă");
}
var id = articole.Max(a => a.Id) + 1;
var articol = new Articol(id, nou.Nume, nou.Cantitate);
articole.Add(articol);
return Results.Created($"/articole/{id}", articol);
});
app.Run();
record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate); 