Menu
CoddyTech

Chaînes de requête

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

Une chaîne de requête est la partie d’une adresse qui suit ? : des paires nom-valeur reliées par &, comme dans /books?author=austen&page=2. Elle ne choisit pas la route ; elle ajoute des options à la requête. Un paramètre lambda dont le nom ne figure pas dans la route est lu dans la chaîne de requête.

app.MapGet("/books", (string? author, int page = 1) =>
    $"Books by {author ?? "anyone"}, page {page}");

GET /books?author=austen renvoie Books by austen, page 1. Un paramètre nullable, comme string?, ou qui a une valeur par défaut est facultatif. Un string simple est obligatoire : sans lui, ASP.NET Core renvoie 400 Bad Request et la lambda ne s’exécute jamais.

challenge icon

Défi

Facile

GET /api/recipes apprend à filtrer : ?category=soup ne conserve que les soupes.

  1. Dans Program.cs, donne à la lambda GET /api/recipes un paramètre string? category.
  2. Renvoie les recettes dont Category est égal à category. Lorsque category est null, renvoie toutes les recettes : recipes.Where(r => category is null || r.Category == category).

Essaie : appuie sur « Exécuter ». GET /api/recipes?category=soup renvoie les deux soupes, d’ids 1 et 3. Envoie GET /api/recipes : les trois recettes. Envoie GET /api/recipes?category=dessert : une liste vide, [].

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.MapGet("/api/recipes/{id:int}", (int id) => recipes.FirstOrDefault(r => r.Id == id));

app.Run();

Toutes les leçons de Minimal APIs