Einen JSON-Body lesen
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 7 von 20.
Eine POST-Anfrage sendet Daten in ihrem Body, üblicherweise als JSON. Wenn eine POST-Lambda einen Record-Parameter entgegennimmt, liest ASP.NET Core den Body als JSON ein und überträgt die Werte darauf, wobei die Groß- und Kleinschreibung der Namen keine Rolle spielt.
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 antwortet mit 201 Created, dem Status für eine neue Ressource, einem Location-Header mit ihrer Adresse und der Ressource als Body. Ein Wert des falschen Typs, zum Beispiel "text": 5, führt zu einer Antwort mit 400, bevor die Lambda ausgeführt wird. Eine Eigenschaft, die im JSON fehlt, erhält ihren Standardwert: null oder 0. Auf einem Laptop sendet curl mit -d einen Body; hier gibt es in der Anfrageleiste ein Body-Feld.
Aufgabe
EinfachClients können Rezepte hinzufügen. Sie senden alles außer der id, und die API wählt die nächste id aus.
- Füge in
Recipe.csrecord NewRecipe(string Name, string Category, int Minutes);hinzu. - Füge in
Program.csunterhalb der Listevar nextId = 4;hinzu. - Bilde
POST /api/recipesab. Die Lambda-Funktion nimmtNewRecipe inputentgegen, erstelltnew Recipe(nextId++, input.Name, input.Category, input.Minutes)und fügt es zurecipeshinzu. - Gib
Results.Created($"/api/recipes/{recipe.Id}", recipe)zurück.
Probiere es aus: Klicke auf „Ausführen“, wähle POST aus, gib den Pfad /api/recipes und den Body {"name":"Waffles","category":"breakfast","minutes":20} ein und klicke dann auf „Senden“. Die Antwort hat den Status 201 und enthält {"id":4,"name":"Waffles","category":"breakfast","minutes":20}; im Tab „Header“ wird Location: /api/recipes/4 angezeigt. Sende GET /api/recipes/4: Waffles. Bei jedem Klick auf „Senden“ werden deine früheren POST-Anfragen in einer frischen App erneut ausgeführt, sodass das Rezept weiterhin vorhanden ist. Sende die POST-Anfrage noch einmal: id 5.
Probier es selbst
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();
Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.
Alle Lektionen in Minimal APIs
1Erste Endpoints
Dein erster EndpointJSON zurückgeben4Middleware und Protokollierung
Deine erste Middleware2Ergebnisse und JSON-Bodies
OK und Nicht gefunden