الإنشاء باستخدام POST
جزء من قسم واجهات API بنمط REST في رحلة ASP.NET Core على Coddy. الدرس 2 من 20.
تُضيف POST عنصرًا إلى مجموعة. ويُرسَل الطلب إلى عنوان URL الخاص بالمجموعة، لأن العميل لا يعرف المعرّف الجديد؛ فالخادم هو من يختاره. تكون الاستجابة 201 Created، وتتضمن العنصر الجديد بصيغة JSON ورأس Location يحتوي على عنوان URL الخاص بالعنصر الجديد. الرأس سطر نصي يحمل اسمًا ويُرسَل قبل المتن.
var nextId = 8;
app.MapPost("/api/books", (BookInput input) =>
{
var book = new Book(nextId++, input.Title, input.Author);
books.Add(book);
return Results.Created($"/api/books/{book.Id}", book);
});تُقرأ معلمة السجل من متن JSON، وتُمنح الخاصية المفقودة القيمة الافتراضية لنوعها. ويُحدِّد عدّاد معرّفًا لكل كتاب. لا تُنشئ المعرّفات باستخدام Random أو الساعة: يجب أن تمنح الطلبات نفسها المعرّفات نفسها. وهذا مهم هنا لسببين، لأن كل ضغطة على «إرسال» تعيد تشغيل طلباتك السابقة على تطبيق جديد.
التحدي
سهلأتح للعملاء إضافة مهام.
- في
Program.cs، أسفل قائمة المهام، أضف عدّادًا:var nextId = 4; - في أسفل الملف، أسفل
TaskItem، عرّف شكل الجسم:record TaskInput(string Title, bool Done); - اربط
POST /api/tasksبمعاملTaskInput input. أنشئTaskItemباستخدامnextId++وinput.Titleوinput.Done، وأضِفه إلىtasks، وأعِدResults.Created($"/api/tasks/{task.Id}", task).
يعيد الجسم { "title": "Order new chairs" } الرمز 201 مع الترويسة Location: /api/tasks/4 و:
{ "id": 4, "title": "Order new chairs", "done": false }جرّب ذلك: اضغط على تشغيل، واختر POST، وأبقِ المسار /api/tasks، واكتب الجسم أعلاه ثم اضغط على إرسال: الرمز 201، وتعرض علامة تبويب الترويسات Location: /api/tasks/4. أرسل GET /api/tasks/4: ستظهر المهمة الجديدة. أرسل طلب POST نفسه مرة أخرى: سيحصل هذا الطلب على المعرّف 5، لأن العمود يعيد تشغيل طلب POST الأول قبله.
جرّب بنفسك
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var tasks = new List<TaskItem>
{
new(1, "Write the project brief", false),
new(2, "Book the meeting room", true),
new(3, "Send the invoice", false),
};
app.MapGet("/api/tasks", () => tasks);
app.MapGet("/api/tasks/{id:int}", (int id) =>
{
var task = tasks.Find(t => t.Id == id);
return task is null ? Results.NotFound() : Results.Ok(task);
});
app.Run();
record TaskItem(int Id, string Title, bool Done);
جميع دروس واجهات API بنمط REST
1الموارد والأفعال
الموارد وURLsالإنشاء باستخدام POST