Чтение тела JSON
Часть раздела Минимальные API путешествия по ASP.NET Core на Coddy. Урок 7 из 20.
POST-запрос отправляет данные в своём теле, обычно в формате JSON. Когда лямбда POST-запроса принимает параметр-запись, ASP.NET Core считывает тело как JSON и помещает данные в этот параметр, сопоставляя имена независимо от регистра.
app.MapPost("/notes", (NewNote input) =>
{
var note = new Note(notes.Count + 1, input.Text);
notes.Add(note);
return Results.Created($"/notes/{note.Id}", note);
});Results.Created возвращает ответ 201 Created — статус для нового ресурса — с заголовком Location, содержащим его адрес, и ресурсом в теле. Значение неправильного типа, например "text": 5, приводит к ответу 400 до запуска лямбды. Свойство, отсутствующее в JSON, получает значение по умолчанию: null или 0. На ноутбуке curl отправляет тело с помощью -d; здесь в панели запроса есть поле Body.
Задание
ЛегкоКлиенты могут добавлять рецепты. Они отправляют всё, кроме идентификатора, а API выбирает следующий идентификатор.
- В
Recipe.csдобавьтеrecord NewRecipe(string Name, string Category, int Minutes);. - В
Program.cs, ниже списка, добавьтеvar nextId = 4;. - Сопоставьте
POST /api/recipes. Его лямбда-функция принимаетNewRecipe input, создаётnew Recipe(nextId++, input.Name, input.Category, input.Minutes)и добавляет его вrecipes. - Верните
Results.Created($"/api/recipes/{recipe.Id}", recipe).
Попробуйте: нажмите «Запустить», выберите POST, введите путь /api/recipes и тело {"name":"Waffles","category":"breakfast","minutes":20}, затем нажмите «Отправить». В ответе будет статус 201, а на вкладке Headers отображается Location: /api/recipes/4. Отправьте GET /api/recipes/4: Waffles. При каждом нажатии «Отправить» ваши предыдущие запросы POST повторно выполняются в новом приложении, поэтому рецепт всё ещё там. Отправьте запрос POST ещё раз: идентификатор 5.
Попробуйте сами
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", (string? category) =>
recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
var recipe = recipes.FirstOrDefault(r => r.Id == id);
if (recipe is null)
return Results.NotFound(new { error = $"Recipe {id} not found" });
return Results.Ok(recipe);
});
app.Run();
В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.
Все уроки раздела Минимальные API
2Результаты и тела JSON
ОК и не найдено