Menu
CoddyTech

Параметры маршрута

Часть раздела Минимальные API путешествия по ASP.NET Core на Coddy. Урок 3 из 20.

Для каждого рецепта создавать отдельный маршрут — значит никогда не закончить. Параметр маршрута — это часть пути в фигурных скобках: он соответствует любому значению в этом месте.

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

GET /orders/42 возвращает Order 42. ASP.NET Core передаёт значение параметру лямбда-функции с тем же именем и преобразует текст 42 в тип параметра, здесь это int. Если имя параметра отсутствует в маршруте, его значение ищется в строке запроса; если его нет и там, ответом будет 400 Bad Request. Код состояния — это число в начале каждого ответа: 200 означает OK, а коды от 400 до 499 означают, что запрос был некорректным.

challenge icon

Задание

Легко

У каждого рецепта свой адрес: /api/recipes/1, /api/recipes/2 и так далее.

  1. В Program.cs, ниже GET /api/recipes, сопоставь GET /api/recipes/{id}.
  2. Его лямбда принимает int id и возвращает рецепт, у которого Id равен id. Выражение recipes.FirstOrDefault(r => r.Id == id) находит его.

Попробуй: нажми «Запустить». GET /api/recipes/2 возвращает ответ {"id":2,"name":"Pancakes","category":"breakfast","minutes":15}. Отправь GET /api/recipes/99: рецепта с таким идентификатором нет, поэтому FirstOrDefault возвращает null, а ответ имеет статус 200 и тело null. В следующей главе для него будет возвращаться статус 404.

Попробуйте сами

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

Все уроки раздела Минимальные API