قيود المسار
جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 4 من 20.
يطابق GET /orders/abc المسار /orders/{number}، ثم يفشل في تحويل abc إلى int: 400 طلب غير صالح. يحدّ قيد المسار الذي يأتي بعد نقطتين مما يمكن أن تطابقه المعلمة، ولذلك لا يطابق هذا المسار أي مسار وتكون الاستجابة 404 غير موجود.
app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");يطابق :int الأعداد الصحيحة، ويطابق :alpha الحروف، لذا يصل كل من /orders/7 و/orders/abc إلى مسار واحد. ومن القيود الأخرى :guid و:min(1) و:length(3)، ويمكن ربطها معًا: {number:int:min(1)}. تختار القيود مسارًا؛ ولا تتحقق من إدخال المستخدم، لأن القيمة المرفوضة تؤدي إلى استجابة 404، لا 400.
التحدي
سهليعرض GET /api/recipes/abc إجابة 400 مع خطأ بشأن ربط int id. لن تكون لأي وصفة قيمة عنوان كهذه، لذا ينبغي أن تكون الإجابة 404.
- في
Program.cs، غيّر مسار نقطة النهاية من الدرس السابق إلى/api/recipes/{id:int}. - أبقِ مسارًا واحدًا لها: غيّر السطر الحالي، ولا تضف سطرًا ثانيًا.
جرّب ذلك: اضغط على «تشغيل»: سيظل GET /api/recipes/2 يعرض وصفة Pancakes. أرسل GET /api/recipes/abc: الحالة 404 ونص الاستجابة فارغ. تعرض قائمة Routes GET /api/recipes/{id:int}.
جرّب بنفسك
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.MapGet("/api/recipes/{id}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.