Menu
CoddyTech

Чтение тела 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.

challenge icon

Задание

Легко

Клиенты могут добавлять рецепты. Они отправляют всё, кроме идентификатора, а API выбирает следующий идентификатор.

  1. В Recipe.cs добавьте record NewRecipe(string Name, string Category, int Minutes);.
  2. В Program.cs, ниже списка, добавьте var nextId = 4;.
  3. Сопоставьте POST /api/recipes. Его лямбда-функция принимает NewRecipe input, создаёт new Recipe(nextId++, input.Name, input.Category, input.Minutes) и добавляет его в recipes.
  4. Верните 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();
quiz iconПроверьте себя

В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.

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