Menu
CoddyTech

Đọc phần thân JSON

Thuộc phần Minimal API trong hành trình ASP.NET Core của Coddy. Bài học 7 trên 20.

Một yêu cầu POST gửi dữ liệu trong phần thân, thường ở dạng JSON. Khi một lambda POST nhận tham số bản ghi, ASP.NET Core đọc phần thân dưới dạng JSON vào tham số đó, khớp tên bất kể chữ hoa hay chữ thường.

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 trả về 201 Created, mã trạng thái cho biết có tài nguyên mới, cùng với tiêu đề Location chứa địa chỉ của tài nguyên và tài nguyên đó trong phần thân. Giá trị sai kiểu, chẳng hạn như "text": 5, sẽ trả về 400 trước khi lambda chạy. Thuộc tính bị thiếu trong JSON sẽ nhận giá trị mặc định: null hoặc 0. Trên máy tính xách tay, curl gửi phần thân bằng -d; ở đây, thanh yêu cầu có một ô Body.

challenge icon

Thử thách

Dễ

Khách hàng có thể thêm công thức nấu ăn. Họ gửi mọi thứ trừ id, còn API sẽ chọn id tiếp theo.

  1. Trong Recipe.cs, thêm record NewRecipe(string Name, string Category, int Minutes);.
  2. Trong Program.cs, bên dưới danh sách, thêm var nextId = 4;.
  3. Ánh xạ POST /api/recipes. Lambda nhận NewRecipe input, tạo new Recipe(nextId++, input.Name, input.Category, input.Minutes) rồi thêm đối tượng đó vào recipes.
  4. Trả về Results.Created($"/api/recipes/{recipe.Id}", recipe).

Thử nhé: nhấn Chạy, chọn POST, nhập đường dẫn /api/recipes và phần thân {"name":"Waffles","category":"breakfast","minutes":20}, rồi nhấn Gửi. Câu trả lời có mã trạng thái 201 cùng {"id":4,"name":"Waffles","category":"breakfast","minutes":20}, còn thẻ Headers hiển thị Location: /api/recipes/4. Gửi GET /api/recipes/4: Waffles. Mỗi lần nhấn Gửi, ứng dụng mới sẽ chạy lại các yêu cầu POST trước đó, nên công thức vẫn còn đó. Gửi lại yêu cầu POST: id 5.

Tự làm thử

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 iconTự kiểm tra

Bài học này có một bài trắc nghiệm ngắn. Bắt đầu bài học để trả lời và theo dõi tiến độ.

Tất cả bài học trong Minimal API