Menu
CoddyTech

Menolak Input yang Tidak Valid

Termasuk bagian REST API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 6 dari 20.

Body permintaan bisa berhasil diikat, tetapi tetap tidak masuk akal: email kosong, harga negatif. Berikan jawaban 400 Bad Request dan jelaskan masalahnya dalam format yang dapat dibaca client. Results.ValidationProblem menerima dictionary yang memetakan nama field ke pesan:

if (string.IsNullOrWhiteSpace(input.Email))
{
    return Results.ValidationProblem(new Dictionary<string, string[]>
    {
        ["email"] = ["Email is required."],
    });
}

Jawabannya adalah 400 dengan tipe konten application/problem+json dan body berikut:

{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": { "email": ["Email is required."] } }

Lakukan pemeriksaan sebelum mengubah apa pun agar permintaan yang ditolak tidak mengubah data. Body yang bukan JSON valid tidak pernah mencapai lambda-mu: ASP.NET Core menjawab 400 untuknya.

challenge icon

Tantangan

Mudah

Saat ini, POST /api/tasks dengan { "title": "" } menambahkan tugas tanpa judul. Tolak permintaan itu.

  1. Di awal lambda POST /api/tasks, sebelum nextId++, periksa judul dengan string.IsNullOrWhiteSpace(input.Title). Pemeriksaan ini menangani judul yang tidak ada (null), judul kosong, dan judul yang hanya terdiri dari spasi.
  2. Jika pemeriksaan gagal, kembalikan Results.ValidationProblem dengan field title dan pesan Title is required., sehingga body-nya berisi:
    "errors": { "title": ["Title is required."] }
  3. Tambahkan pemeriksaan yang sama di awal lambda PUT /api/tasks/{id:int}.

Coba: tekan Jalankan dan kirim POST { "title": "" } ke /api/tasks: 400 dan error di atas. Kirim GET /api/tasks: tetap ada tiga tugas. Kirim PUT { "title": " ", "done": true } ke /api/tasks/1: 400, dan judul tugas 1 tetap sama. Kirim POST { "title": "Order new chairs" }: 201 dengan id 4.

Coba sendiri

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var tasks = new List<TaskItem>
{
    new(1, "Write the project brief", false),
    new(2, "Book the meeting room", true),
    new(3, "Send the invoice", false),
};
var nextId = 4;

app.MapGet("/api/tasks", () => tasks);

app.MapGet("/api/tasks/{id:int}", (int id) =>
{
    var task = tasks.Find(t => t.Id == id);
    return task is null ? Results.NotFound() : Results.Ok(task);
});

app.MapPost("/api/tasks", (TaskInput input) =>
{
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    var task = tasks[index];
    tasks[index] = task with
    {
        Title = patch.Title ?? task.Title,
        Done = patch.Done ?? task.Done,
    };
    return Results.Ok(tasks[index]);
});

app.MapDelete("/api/tasks/{id:int}", (int id) =>
{
    var removed = tasks.RemoveAll(t => t.Id == id);
    return removed == 0 ? Results.NotFound() : Results.NoContent();
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
record TaskPatch(string? Title, bool? Done);
quiz iconUji dirimu

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

Semua pelajaran di REST API