Menu
CoddyTech

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.

challenge icon

Aufgabe

Einfach

Clients können Rezepte hinzufügen. Sie senden alles außer der id, und die API wählt die nächste id aus.

  1. Füge in Recipe.cs record NewRecipe(string Name, string Category, int Minutes); hinzu.
  2. Füge in Program.cs unterhalb der Liste var nextId = 4; hinzu.
  3. Bilde POST /api/recipes ab. Die Lambda-Funktion nimmt NewRecipe input entgegen, erstellt new Recipe(nextId++, input.Name, input.Category, input.Minutes) und fügt es zu recipes hinzu.
  4. 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();
quiz iconTeste dich selbst

Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.

Alle Lektionen in Minimal APIs