不正なリクエスト
CoddyのASP.NET Coreジャーニー「Minimal API」セクションの一部。レッスン 8/20。
リクエスト本文ではプロパティを省略できます。{} でもバインドされ、レコードで string と指定されていても、input.Email は null になります。NULL 許容参照型が警告を出すのはコードのコンパイル時だけで、JSON をチェックすることはありません。そのためエンドポイントは値を自分でチェックし、何かを変更する前に Results.BadRequest で 400 Bad Request を返します。
app.MapPost("/signups", (Signup input) =>
{
if (string.IsNullOrWhiteSpace(input.Email))
return Results.BadRequest(new { error = "Email is required" });
signups.Add(input);
return Results.Created($"/signups/{signups.Count}", input);
});string.IsNullOrWhiteSpace は、null、""、および空白文字だけのテキストに対して true になります。エラー本文は、クライアントに修正すべき箇所を伝えます。
チャレンジ
簡単POST /api/recipes は、名前がないレシピや調理時間がないレシピを拒否します。
Program.csで、POST ラムダの先頭にあるstring.IsNullOrWhiteSpace(input.Name)の場合に、Results.BadRequest(new { error = "Name is required" })を返します。- 次に、
input.Minutes <= 0の場合に、Results.BadRequest(new { error = "Minutes must be more than 0" })を返します。 - どちらのチェックもレシピを作成して追加する前に行われるため、拒否されたレシピは保存されず、IDも使用しません。
試してみましょう:「実行」を押して、{"category":"soup","minutes":30} を /api/recipes に POST します。結果はステータス 400 と {"error":"Name is required"} です。{"name":"Toast","category":"breakfast","minutes":0} を POST すると、{"error":"Minutes must be more than 0"} が返されます。次に、{"name":"Waffles","category":"breakfast","minutes":20} を POST すると、ID 4 とともに 201 が返されます。
自分で試してみよう
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),
};
var nextId = 4;
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.MapPost("/api/recipes", (NewRecipe input) =>
{
var recipe = new Recipe(nextId++, input.Name, input.Category, input.Minutes);
recipes.Add(recipe);
return Results.Created($"/api/recipes/{recipe.Id}", recipe);
});
app.Run();