Mini-proiect: API CRUD pentru notițe
Ai învățat separat cele patru operații: creare, citire, actualizare, ștergere. Acum le pui împreună într-un singur API complet, cel din spatele unei aplicații de notițe ca Google Keep sau Notes. Acesta este tiparul pe care îl vei repeta în aproape orice proiect backend: o resursă, cinci endpoint-uri, coduri de status corecte.
Cele cinci operații ale unei resurse
Orice resursă REST (produse, comenzi, notițe) are de obicei aceleași cinci endpoint-uri. Tabelul de mai jos este contractul API-ului de notițe:
| Operația | Metoda și calea | Corp în cerere | Succes | Eroare |
|---|---|---|---|---|
| toate notițele | GET /notite | nu | 200 + listă | nu are |
| o notiță | GET /notite/{id} | nu | 200 + notița | 404 |
| creare | POST /notite | NotitaNoua | 201 + Location + notița | 400 (date greșite) |
| actualizare | PUT /notite/{id} | NotitaNoua | 200 + notița nouă | 404 |
| ștergere | DELETE /notite/{id} | nu | 204 | 404 |
Observă simetria: adresa colecției (/notite) pentru listă și creare, adresa unui element (/notite/{id}) pentru citire, actualizare și ștergere. Metoda HTTP spune ce faci, iar calea spune cu ce.
Modelul și datele inițiale
record Notita(int Id, string Titlu, string Text); // resursa, cu id record NotitaNoua(string Titlu, string Text); // ce trimite clientul la POST și PUT
Lista pornește cu două notițe. Pentru id-ul nou folosim varianta sigură: notite.Count == 0 ? 1 : notite.Max(n => n.Id) + 1, pentru că un utilizator poate șterge toate notițele, iar Max pe o listă goală aruncă o excepție.
Citirea și crearea
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var notite = new List<Notita>
{
new(1, "Cumpărături", "Lapte, pâine, ouă"),
new(2, "Curs", "Lecția 19 din ASP.NET Core")
};
app.MapGet("/notite", () => notite);
app.MapGet("/notite/{id:int}", (int id) =>
{
var notita = notite.FirstOrDefault(n => n.Id == id);
return notita is null ? Results.NotFound() : Results.Ok(notita);
});
app.MapPost("/notite", (NotitaNoua noua) =>
{
var id = notite.Count == 0 ? 1 : notite.Max(n => n.Id) + 1;
var notita = new Notita(id, noua.Titlu, noua.Text);
notite.Add(notita);
return Results.Created($"/notite/{id}", notita);
});
app.Run();
record Notita(int Id, string Titlu, string Text);
record NotitaNoua(string Titlu, string Text);
// GET /notite
// POST /notite {"titlu": "Idei", "text": "Aplicație de rețete"}
// GET /notite/3
// GET /notite/8GET /notite → 200 OK
[{"id":1,"titlu":"Cumpărături","text":"Lapte, pâine, ouă"},{"id":2,"titlu":"Curs","text":"Lecția 19 din ASP.NET Core"}]
POST /notite → 201 Created
Location: /notite/3
{"id":3,"titlu":"Idei","text":"Aplicație de rețete"}
GET /notite/3 → 200 OK
{"id":3,"titlu":"Idei","text":"Aplicație de rețete"}
GET /notite/8 → 404 Not FoundActualizarea și ștergerea
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var notite = new List<Notita>
{
new(1, "Cumpărături", "Lapte, pâine, ouă"),
new(2, "Curs", "Lecția 19 din ASP.NET Core")
};
app.MapGet("/notite", () => notite);
app.MapPut("/notite/{id:int}", (int id, NotitaNoua noua) =>
{
var index = notite.FindIndex(n => n.Id == id);
if (index == -1)
{
return Results.NotFound();
}
notite[index] = new Notita(id, noua.Titlu, noua.Text);
return Results.Ok(notite[index]);
});
app.MapDelete("/notite/{id:int}", (int id) =>
notite.RemoveAll(n => n.Id == id) == 0 ? Results.NotFound() : Results.NoContent());
app.Run();
record Notita(int Id, string Titlu, string Text);
record NotitaNoua(string Titlu, string Text);
// PUT /notite/1 {"titlu": "Cumpărături", "text": "Lapte, pâine, ouă, cafea"}
// DELETE /notite/2
// DELETE /notite/2
// GET /notitePUT /notite/1 → 200 OK
{"id":1,"titlu":"Cumpărături","text":"Lapte, pâine, ouă, cafea"}
DELETE /notite/2 → 204 No Content
DELETE /notite/2 → 404 Not Found
GET /notite → 200 OK
[{"id":1,"titlu":"Cumpărături","text":"Lapte, pâine, ouă, cafea"}]MapDelete este scris aici pe o singură linie: RemoveAll șterge și întoarce numărul de elemente șterse, iar ternarul alege 404 sau 204. E exact aceeași logică din lecția despre DELETE, doar mai compactă.
Cum l-ai testa în realitate
Într-un proiect real ai porni API-ul cu dotnet run și ai testa fiecare operație din Postman (o colecție cu cinci cereri) sau dintr-un fișier notite.http:
@baza = http://localhost:5000
GET {{baza}}/notite
###
POST {{baza}}/notite
Content-Type: application/json
{ "titlu": "Idei", "text": "Aplicație de rețete" }
###
PUT {{baza}}/notite/1
Content-Type: application/json
{ "titlu": "Cumpărături", "text": "Lapte, pâine, ouă, cafea" }
###
DELETE {{baza}}/notite/2Fișierul .http se salvează în proiect, lângă cod, ca toată echipa să poată testa API-ul la fel. Mai târziu în curs vei automatiza aceste verificări cu teste xUnit.
Lista de verificare a unui API CRUD
- fiecare metodă are calea potrivită (colecție sau element);
- id-ul nou îl alege serverul, nu clientul;
- POST întoarce 201 cu Location;
- GET, PUT și DELETE pe un id inexistent întorc 404, nu 500 și nici 200 cu null;
- DELETE întoarce 204, fără corp;
- tipurile (Notita, NotitaNoua) stau după app.Run();.
Construiește API-ul CRUD complet pentru notițe, după tabelul din lecție. Lista pornește cu (1, Cumpărături, Lapte, pâine, ouă) și (2, Curs, Lecția 19 din ASP.NET Core). Laboratorul trimite, în ordine: GET /notite, POST /notite (Idei / Aplicație de rețete), GET /notite/2, PUT /notite/2 (Curs, Lecția 20: recapitulare), DELETE /notite/1 și GET /notite.
- GET /notite întoarce lista; GET /notite/{id:int} întoarce 200 sau 404.
- POST /notite primește NotitaNoua, alege id-ul și întoarce Results.Created($"/notite/{id}", notita).
- PUT /notite/{id:int} înlocuiește notița și întoarce 200 cu ea, sau 404.
- DELETE /notite/{id:int} întoarce 204 sau 404.
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var notite = new List<Notita>
{
new(1, "Cumpărături", "Lapte, pâine, ouă"),
new(2, "Curs", "Lecția 19 din ASP.NET Core")
};
app.MapGet("/notite", () => notite);
app.MapGet("/notite/{id:int}", (int id) =>
{
var notita = notite.FirstOrDefault(n => n.Id == id);
return notita is null ? Results.NotFound() : Results.Ok(notita);
});
app.MapPost("/notite", (NotitaNoua noua) =>
{
var id = notite.Count == 0 ? 1 : notite.Max(n => n.Id) + 1;
var notita = new Notita(id, noua.Titlu, noua.Text);
notite.Add(notita);
return Results.Created($"/notite/{id}", notita);
});
app.MapPut("/notite/{id:int}", (int id, NotitaNoua noua) =>
{
var index = notite.FindIndex(n => n.Id == id);
if (index == -1)
{
return Results.NotFound();
}
notite[index] = new Notita(id, noua.Titlu, noua.Text);
return Results.Ok(notite[index]);
});
app.MapDelete("/notite/{id:int}", (int id) =>
notite.RemoveAll(n => n.Id == id) == 0 ? Results.NotFound() : Results.NoContent());
app.Run();
record Notita(int Id, string Titlu, string Text);
record NotitaNoua(string Titlu, string Text); 