معلمات المسار
جزء من قسم واجهات 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 أن الطلب كان غير صحيح.
التحدي
سهللكل وصفة عنوانها الخاص: /api/recipes/1 و/api/recipes/2 وهكذا.
- في
Program.cs، أسفلGET /api/recipes، اربطGET /api/recipes/{id}. - تأخذ لامبداه
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();