حالة Ok وحالة Not Found
جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 6 من 20.
تُرجع نقطة النهاية التي يمكنها الإجابة بأكثر من طريقة نتيجةً من Results، والتي تحدد رمز الحالة. تعني Results.Ok(value) الرمز 200 مع القيمة بتنسيق JSON، وتعني Results.NotFound() الرمز 404 «غير موجود»، وهو الرمز الذي يشير إلى شيء غير موجود.
app.MapGet("/books/{id:int}", (int id) =>
{
var book = books.FirstOrDefault(b => b.Id == id);
if (book is null)
return Results.NotFound(new { error = "No such book" });
return Results.Ok(book);
});يمر كل return عبر Results، لذا تشترك جميعها في نوع واحد هو IResult، ويُترجم التعبير اللامبدا بنجاح. إن new { error = "No such book" } كائن مجهول: يكتبه ASP.NET Core بالشكل {"error":"No such book"}، وهو نص يخبر العميل بما حدث من خطأ.
التحدي
سهليستجيب GET /api/recipes/99 بالرمز 200 مع null. لا يستطيع العميل تمييز ذلك عن وصفة موجودة، لذا ينبغي أن يستجيب بالرمز 404.
- في
Program.cs، اجعل لامبداGET /api/recipes/{id:int}جسمًا كتليًا،{ ... }، يعثر على الوصفة باستخدامFirstOrDefault. - عندما تكون
null، أرجِعResults.NotFound(new { error = $"Recipe {id} not found" }). بالنسبة إلى المعرّف 99، يكون نص الاستجابة{"error":"Recipe 99 not found"}. - وإلا فأرجِع
Results.Ok(recipe).
جرّب ذلك: اضغط على «تشغيل». يستجيب GET /api/recipes/99 برمز الحالة 404 مع {"error":"Recipe 99 not found"}. أرسِل GET /api/recipes/2: رمز الحالة 200 ووصفة Pancakes، كما في السابق.
جرّب بنفسك
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) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
جميع دروس واجهات API المصغّرة
4البرمجيات الوسيطة والتسجيل
أول Middleware لك2النتائج ومحتوى JSON
حالة Ok وحالة Not Found