POST ile Oluşturma
Coddy'nin ASP.NET Core Journey'sinin REST API'leri bölümünün bir parçası. Ders 2 / 20.
POST, koleksiyona bir öğe ekler. Yeni kimliği bilmediği için istemci, koleksiyonun URL'sine gönderir: kimliği sunucu seçer. Yanıt, JSON olarak yeni öğeyi ve yeni öğenin URL'sini içeren bir Location başlığını taşıyan 201 Created olur. Başlık, gövdeden önce gönderilen adlandırılmış bir metin satırıdır.
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);
});Kayıt parametresi JSON gövdesinden okunur ve eksik bir özellik, türünün varsayılan değerini alır. Bir sayaç her kitaba kendi kimliğini verir. Kimlikleri oluşturmak için asla Random veya saati kullanma: aynı istekler aynı kimlikleri vermelidir. Burada bu iki kat önemlidir; çünkü her Gönderme, önceki isteklerini yeni başlatılmış bir uygulamada yeniden oynatır.
Görev
Kolayİstemcilerin görev eklemesini sağlayın.
Program.csdosyasında, görev listesinin altına bir sayaç ekleyin:var nextId = 4;- Dosyanın en altına,
TaskItemtanımının altına, gövdenin şeklini bildirin:record TaskInput(string Title, bool Done); TaskInput inputparametresiylePOST /api/tasksyolunu eşleyin.nextId++,input.Titleveinput.Donekullanarak birTaskItemoluşturun, bunutaskslistesine ekleyin veResults.Created($"/api/tasks/{task.Id}", task)yanıtını döndürün.
{ "title": "Order new chairs" } gövdesi, Location: /api/tasks/4 başlığıyla birlikte 201 yanıtı ve şunu döndürür:
{ "id": 4, "title": "Order new chairs", "done": false }Deneyin: Çalıştır'a basın, POST'u seçin, /api/tasks yolunu değiştirmeyin, yukarıdaki gövdeyi yazın ve Gönder'e basın: 201; Headers sekmesinde Location: /api/tasks/4 görünür. GET /api/tasks/4 isteğini gönderin: yeni görev. Aynı POST isteğini tekrar gönderin: bu istek 5 kimliğini alır, çünkü sütun önce ilk POST isteğini yeniden oynatır.
Kendin dene
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 API'leri bölümündeki tüm dersler
1Kaynaklar ve Fiiller
Kaynaklar ve URL'lerPOST ile Oluşturma