Menu
CoddyTech

Paramètres de route

Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 3 sur 20.

Une route par recette ne finirait jamais. Un paramètre de route est une partie du chemin entre accolades : il correspond à n’importe quelle valeur à cet emplacement.

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

GET /orders/42 renvoie Order 42. ASP.NET Core transmet la valeur au paramètre lambda portant le même nom et convertit le texte 42 vers le type du paramètre, ici int. Si le nom d’un paramètre ne figure pas dans la route, sa valeur est recherchée dans la chaîne de requête ; si elle ne s’y trouve pas non plus, la réponse est 400 Bad Request. Un code d’état est le nombre au début de chaque réponse : 200 signifie OK, et les codes de 400 à 499 signifient que la requête était incorrecte.

challenge icon

Défi

Facile

Chaque recette a sa propre adresse : /api/recipes/1, /api/recipes/2, et ainsi de suite.

  1. Dans Program.cs, sous GET /api/recipes, mappe GET /api/recipes/{id}.
  2. Sa lambda prend int id et renvoie la recette dont Id est égal à id. recipes.FirstOrDefault(r => r.Id == id) la trouve.

Essaie : appuie sur Exécuter. GET /api/recipes/2 renvoie {"id":2,"name":"Pancakes","category":"breakfast","minutes":15}. Envoie GET /api/recipes/99 : aucune recette n’a cet identifiant, donc FirstOrDefault renvoie null et la réponse a le statut 200 avec le corps null. Le chapitre suivant renverra le statut 404 dans ce cas.

Essayez vous-même

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();

Toutes les leçons de Minimal APIs