قراءة محتوى 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.
التحدي
سهليمكن للعملاء إضافة وصفات. يرسلون كل شيء باستثناء المعرّف، وتتولى API اختيار المعرّف التالي.
- في
Recipe.cs، أضفrecord NewRecipe(string Name, string Category, int Minutes);. - في
Program.cs، أضفvar nextId = 4;أسفل القائمة. - اربط
POST /api/recipes. تتلقى لامبداNewRecipe input، وتنشئnew Recipe(nextId++, input.Name, input.Category, input.Minutes)وتضيفه إلىrecipes. - أعِد
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();
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس واجهات API المصغّرة
4البرمجيات الوسيطة والتسجيل
أول Middleware لك2النتائج ومحتوى JSON
حالة Ok وحالة Not Found