Menu
CoddyTech

قيود المسار

جزء من قسم واجهات 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.

challenge icon

التحدي

سهل

يعرض GET /api/recipes/abc إجابة 400 مع خطأ بشأن ربط int id. لن تكون لأي وصفة قيمة عنوان كهذه، لذا ينبغي أن تكون الإجابة 404.

  1. في Program.cs، غيّر مسار نقطة النهاية من الدرس السابق إلى /api/recipes/{id:int}.
  2. أبقِ مسارًا واحدًا لها: غيّر السطر الحالي، ولا تضف سطرًا ثانيًا.

جرّب ذلك: اضغط على «تشغيل»: سيظل 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();
quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

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