Đọ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.
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.
- Trong
Recipe.cs, thêmrecord NewRecipe(string Name, string Category, int Minutes);. - Trong
Program.cs, bên dưới danh sách, thêmvar nextId = 4;. - Ánh xạ
POST /api/recipes. Lambda nhậnNewRecipe input, tạonew Recipe(nextId++, input.Name, input.Category, input.Minutes)rồi thêm đối tượng đó vàorecipes. - 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();
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
1Các endpoint đầu tiên
Endpoint đầu tiên của bạnTrả về JSON2Kết quả và phần thân JSON
OK và không tìm thấy