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.
Défi
FacileChaque recette a sa propre adresse : /api/recipes/1, /api/recipes/2, et ainsi de suite.
- Dans
Program.cs, sousGET /api/recipes, mappeGET /api/recipes/{id}. - Sa lambda prend
int idet renvoie la recette dontIdest é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
1Premiers endpoints
Votre premier endpointRenvoyer du JSON2Résultats et corps JSON
OK et introuvable