Menu
CoddyTech

Leggere un corpo JSON

Fa parte della sezione Minimal API del percorso ASP.NET Core di Coddy. Lezione 7 di 20.

Una richiesta POST invia i dati nel suo corpo, di solito in formato JSON. Quando una lambda POST accetta un parametro di tipo record, ASP.NET Core legge il corpo come JSON e lo assegna al parametro, senza distinguere tra maiuscole e minuscole nei nomi.

app.MapPost("/notes", (NewNote input) =>
{
    var note = new Note(notes.Count + 1, input.Text);
    notes.Add(note);
    return Results.Created($"/notes/{note.Id}", note);
});

Results.Created restituisce 201 Created, il codice di stato per una nuova risorsa, con un'intestazione Location contenente il suo indirizzo e la risorsa nel corpo. Un valore del tipo sbagliato, come "text": 5, restituisce 400 prima che venga eseguita la lambda. Una proprietà omessa dal JSON assume il valore predefinito: null o 0. Su un portatile, curl invia un corpo con -d; qui la barra della richiesta contiene una casella Body.

challenge icon

Sfida

Facile

I client possono aggiungere ricette. Inviano tutto tranne l’id e l’API assegna l’id successivo.

  1. In Recipe.cs, aggiungi record NewRecipe(string Name, string Category, int Minutes);.
  2. In Program.cs, sotto l’elenco, aggiungi var nextId = 4;.
  3. Mappa POST /api/recipes. La sua lambda accetta NewRecipe input, crea new Recipe(nextId++, input.Name, input.Category, input.Minutes) e lo aggiunge a recipes.
  4. Restituisci Results.Created($"/api/recipes/{recipe.Id}", recipe).

Prova: premi Esegui, scegli POST, inserisci il percorso /api/recipes e il corpo {"name":"Waffles","category":"breakfast","minutes":20}, quindi premi Invia. La risposta è lo stato 201 con {"id":4,"name":"Waffles","category":"breakfast","minutes":20} e la scheda Headers mostra Location: /api/recipes/4. Invia GET /api/recipes/4: Waffles. Ogni invio ripete i POST precedenti in una nuova app, quindi la ricetta è ancora presente. Invia di nuovo il POST: id 5.

Provalo tu

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", (string? category) =>
    recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.Run();
quiz iconMettiti alla prova

Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.

Tutte le lezioni di Minimal API