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.
Sfida
FacileI client possono aggiungere ricette. Inviano tutto tranne l’id e l’API assegna l’id successivo.
- In
Recipe.cs, aggiungirecord NewRecipe(string Name, string Category, int Minutes);. - In
Program.cs, sotto l’elenco, aggiungivar nextId = 4;. - Mappa
POST /api/recipes. La sua lambda accettaNewRecipe input, creanew Recipe(nextId++, input.Name, input.Category, input.Minutes)e lo aggiunge arecipes. - 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();
Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.
Tutte le lezioni di Minimal API
2Risultati e corpi JSON
OK e non trovato