الطلبات غير الصالحة
جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 8 من 20.
يمكن أن يحذف نص الطلب خاصيةً ما: يُربط {}، وتكون قيمة input.Email هي null رغم أن السجل يحدد النوع string. لا تُصدر الأنواع المرجعية القابلة للإلغاء تحذيرات إلا عند تجميع الكود؛ فهي لا تتحقق من JSON مطلقًا. لذلك تتحقق نقطة النهاية من القيم بنفسها، وتُرجع 400 Bad Request باستخدام Results.BadRequest قبل أن تغيّر أي شيء.
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، وللقيمة ""، وللنص الذي يتكون من مسافات فقط. يوضح نص الخطأ للعميل ما الذي ينبغي إصلاحه.
التحدي
سهليرفض POST /api/recipes وصفةً بلا اسم أو بلا وقت طهي.
- في
Program.cs، في أعلى دالة POST المجهولة، أَعِدResults.BadRequest(new { error = "Name is required" })عندما يتحقق الشرطstring.IsNullOrWhiteSpace(input.Name). - بعد ذلك، أَعِد
Results.BadRequest(new { error = "Minutes must be more than 0" })عندما يتحقق الشرطinput.Minutes <= 0. - يحدث التحققان قبل إنشاء الوصفة وإضافتها، لذا لا تُحفَظ الوصفة المرفوضة ولا تستهلك معرّفًا.
جرّب ذلك: اضغط على «تشغيل» وأرسل طلب POST يتضمن {"category":"soup","minutes":30} إلى /api/recipes: ستكون الحالة 400 وستظهر {"error":"Name is required"}. أرسل طلب POST يتضمن {"name":"Toast","category":"breakfast","minutes":0}: ستظهر {"error":"Minutes must be more than 0"}. ثم أرسل طلب POST يتضمن {"name":"Waffles","category":"breakfast","minutes":20}: ستحصل على 201 مع المعرّف 4.
جرّب بنفسك
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();
جميع دروس واجهات API المصغّرة
4البرمجيات الوسيطة والتسجيل
أول Middleware لك2النتائج ومحتوى JSON
حالة Ok وحالة Not Found