Menu
CoddyTech

Routenparameter

Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 3 von 20.

Eine Route pro Rezept würde nie enden. Ein Routenparameter ist ein Teil des Pfads in geschweiften Klammern: Er passt zu jedem Wert an dieser Stelle.

app.MapGet("/orders/{number}", (int number) => $"Order {number}");

GET /orders/42 antwortet mit Order 42. ASP.NET Core übergibt den Wert an den Lambda-Parameter mit demselben Namen und wandelt den Text 42 in den Typ des Parameters um, hier int. Ein Parameter, dessen Name nicht in der Route vorkommt, wird stattdessen in der Abfragezeichenfolge gesucht. Ist er auch dort nicht vorhanden, lautet die Antwort 400 Bad Request. Ein Statuscode ist die Zahl am Anfang jeder Antwort: 200 bedeutet OK, und Codes von 400 bis 499 bedeuten, dass die Anfrage fehlerhaft war.

challenge icon

Aufgabe

Einfach

Jedes Rezept erhält eine eigene Adresse: /api/recipes/1, /api/recipes/2 und so weiter.

  1. Füge in Program.cs unter GET /api/recipes die Zuordnung für GET /api/recipes/{id} hinzu.
  2. Sein Lambda-Ausdruck nimmt int id entgegen und gibt das Rezept zurück, dessen Id gleich id ist. recipes.FirstOrDefault(r => r.Id == id) findet es.

Probiere es aus: Klicke auf „Ausführen“. GET /api/recipes/2 antwortet mit {"id":2,"name":"Pancakes","category":"breakfast","minutes":15}. Sende GET /api/recipes/99: Es gibt kein Rezept mit dieser id, daher gibt FirstOrDefault null zurück, und die Antwort hat den Status 200 mit dem Inhalt null. Im nächsten Kapitel wird dafür 404 zurückgegeben.

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", () => recipes);

app.Run();

Alle Lektionen in Minimal APIs