Menu
CoddyTech

Membaca Body JSON

Termasuk bagian Minimal API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 7 dari 20.

Permintaan POST mengirim data di body-nya, biasanya dalam bentuk JSON. Saat lambda POST menerima parameter record, ASP.NET Core membaca body sebagai JSON ke dalamnya, dengan mencocokkan nama tanpa membedakan huruf besar dan kecil.

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 memberikan jawaban 201 Created, status untuk resource baru, dengan header Location yang memuat alamatnya dan resource tersebut sebagai body. Nilai dengan tipe yang salah, seperti "text": 5, menghasilkan jawaban 400 sebelum lambda dijalankan. Property yang tidak disertakan oleh JSON akan mendapat nilai default: null atau 0. Di laptop, curl mengirim body dengan -d; di sini, bilah permintaan memiliki kotak Body.

challenge icon

Tantangan

Mudah

Client dapat menambahkan resep. Mereka mengirim semua data kecuali id, lalu API memilih id berikutnya.

  1. Di Recipe.cs, tambahkan record NewRecipe(string Name, string Category, int Minutes);.
  2. Di Program.cs, tambahkan var nextId = 4; di bawah list.
  3. Petakan POST /api/recipes. Lambda-nya menerima NewRecipe input, membuat new Recipe(nextId++, input.Name, input.Category, input.Minutes), lalu menambahkannya ke recipes.
  4. Kembalikan Results.Created($"/api/recipes/{recipe.Id}", recipe).

Coba: tekan Jalankan, pilih POST, ketik path /api/recipes dan body {"name":"Waffles","category":"breakfast","minutes":20}, lalu tekan Kirim. Jawabannya adalah status 201 dengan {"id":4,"name":"Waffles","category":"breakfast","minutes":20}, dan tab Headers menampilkan Location: /api/recipes/4. Kirim GET /api/recipes/4: Waffles. Setiap kali kamu menekan Kirim, POST sebelumnya dijalankan kembali di app baru, jadi resepnya tetap ada. Kirim POST sekali lagi: id 5.

Coba sendiri

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 iconUji dirimu

Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.

Semua pelajaran di Minimal API