Menu
CoddyTech

قراءة محتوى JSON

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

يرسل طلب POST البيانات في المتن، وعادةً بتنسيق JSON. عندما تستقبل لامبدا POST معاملاً من نوع سجل، يقرأ ASP.NET Core المتن بتنسيق JSON ويضعه فيه، مع مطابقة الأسماء بغض النظر عن حالة الأحرف.

app.MapPost("/notes", (NewNote input) =>
{
    var note = new Note(notes.Count + 1, input.Text);
    notes.Add(note);
    return Results.Created($"/notes/{note.Id}", note);
});

تعيد Results.Created الاستجابة 201 Created، وهي حالة مورد جديد، مع ترويسة Location التي تحتوي على عنوانه، والمورد في المتن. تؤدي قيمة من نوع غير صحيح، مثل "text": 5، إلى الاستجابة 400 قبل تشغيل اللامبدا. تحصل الخاصية التي لا يتضمنها JSON على قيمتها الافتراضية: null أو 0. على حاسوب محمول، يرسل curl متنًا باستخدام -d؛ وهنا يحتوي شريط الطلب على مربع Body.

challenge icon

التحدي

سهل

يمكن للعملاء إضافة وصفات. يرسلون كل شيء باستثناء المعرّف، وتتولى API اختيار المعرّف التالي.

  1. في Recipe.cs، أضف record NewRecipe(string Name, string Category, int Minutes);.
  2. في Program.cs، أضف var nextId = 4; أسفل القائمة.
  3. اربط POST /api/recipes. تتلقى لامبدا NewRecipe input، وتنشئ new Recipe(nextId++, input.Name, input.Category, input.Minutes) وتضيفه إلى recipes.
  4. أعِد Results.Created($"/api/recipes/{recipe.Id}", recipe).

جرّب ذلك: اضغط على «تشغيل»، واختر POST، واكتب المسار /api/recipes والمتن {"name":"Waffles","category":"breakfast","minutes":20}، ثم اضغط على «إرسال». ستكون الإجابة بالحالة 201، مع {"id":4,"name":"Waffles","category":"breakfast","minutes":20}، وستعرض علامة تبويب Headers Location: /api/recipes/4. أرسل GET /api/recipes/4: Waffles. يعيد كل إرسال تشغيل طلبات POST السابقة على تطبيق جديد، لذا تظل الوصفة موجودة. أرسل طلب POST مرة أخرى: المعرّف 5.

جرّب بنفسك

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) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.Run();
quiz iconاختبر نفسك

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

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