יצירה באמצעות POST
חלק מהיחידה REST APIs במסלול ה-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);
כל השיעורים ביחידה REST APIs
1משאבים ופעלים
משאבים וכתובות URLיצירה באמצעות POST