...
← Curs ASP.NET Core: toate lecțiile
Lecția 19 · Proiect

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țiaMetoda și caleaCorp în cerereSuccesEroare
toate notițeleGET /notitenu200 + listănu are
o notițăGET /notite/{id}nu200 + notița404
crearePOST /notiteNotitaNoua201 + Location + notița400 (date greșite)
actualizarePUT /notite/{id}NotitaNoua200 + notița nouă404
ștergereDELETE /notite/{id}nu204404

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/8
GET /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 Found

Actualizarea ș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 /notite
PUT /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/2
1
Rulezi cererile în ordine și verifici codul fiecărui răspuns.
2
Încerci și cazurile de eroare: un id care nu există, o a doua ștergere.
3
La final faci un GET /notite ca să vezi starea finală.

Fiș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();.
Exercițiul tău

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.
Poți porni de la exemplele din lecție: ai nevoie de câte un MapGet (două), MapPost, MapPut și MapDelete.

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);
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 19 · Mini-proiect: API CRUD pentru notițe
Progres 0% 0 din 22
Lecția curentă 19 / 20 Proiect