Menu
CoddyTech

معلمات المسار

جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 3 من 20.

لن تنتهي أبدًا إذا أنشأت مسارًا لكل وصفة. مُعامل المسار هو جزء من المسار يُكتب بين أقواس معقوفة: ويطابق أي قيمة في ذلك الموضع.

app.MapGet("/orders/{number}", (int number) => $"Order {number}");

يُجيب GET /orders/42 بـ Order 42. يمرر ASP.NET Core القيمة إلى مُعامل الدالة اللامية ذي الاسم نفسه، ويحوّل النص 42 إلى نوع المُعامل، وهو هنا int. إذا لم يكن اسم المُعامل موجودًا في المسار، فسيُبحث عنه في سلسلة الاستعلام، وإذا لم يكن موجودًا هناك أيضًا، فستكون الاستجابة 400 Bad Request. رمز الحالة هو الرقم في بداية كل استجابة: يعني 200 أن الطلب ناجح، وتعني الرموز من 400 إلى 499 أن الطلب كان غير صحيح.

challenge icon

التحدي

سهل

لكل وصفة عنوانها الخاص: /api/recipes/1 و/api/recipes/2 وهكذا.

  1. في Program.cs، أسفل GET /api/recipes، اربط GET /api/recipes/{id}.
  2. تأخذ لامبداه int id وتُرجع الوصفة التي تساوي فيها Id قيمة id. يعثر عليها recipes.FirstOrDefault(r => r.Id == id).

جرّب ذلك: اضغط على «تشغيل». يستجيب GET /api/recipes/2 بـ {"id":2,"name":"Pancakes","category":"breakfast","minutes":15}. أرسل GET /api/recipes/99: لا توجد وصفة لها هذا المعرّف، لذا تُرجع FirstOrDefault القيمة null، وتكون الإجابة بحالة 200 ومتنها null. في الفصل التالي، ستُرجع الإجابة 404 لهذه الحالة.

جرّب بنفسك

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", () => recipes);

app.Run();

جميع دروس واجهات API المصغّرة