Menu
CoddyTech

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.

challenge icon

Görev

Kolay

İstemcilerin görev eklemesini sağlayın.

  1. Program.cs dosyasında, görev listesinin altına bir sayaç ekleyin: var nextId = 4;
  2. Dosyanın en altına, TaskItem tanımının altına, gövdenin şeklini bildirin: record TaskInput(string Title, bool Done);
  3. TaskInput input parametresiyle POST /api/tasks yolunu eşleyin. nextId++, input.Title ve input.Done kullanarak bir TaskItem oluşturun, bunu tasks listesine ekleyin ve Results.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