Membuat dengan POST
Termasuk bagian REST API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 2 dari 20.
POST menambahkan item ke dalam koleksi. Permintaan dikirim ke URL koleksi karena client tidak mengetahui id baru: server yang memilihnya. Jawabannya adalah 201 Created, dengan item baru dalam format JSON dan header Location yang berisi URL item baru. Header adalah baris teks bernama yang dikirim sebelum body.
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);
});Parameter record dibaca dari body JSON, dan property yang tidak ada akan mendapat nilai default dari tipe datanya. Sebuah penghitung memberikan id kepada setiap buku. Jangan pernah membuat id menggunakan Random atau jam: permintaan yang sama harus menghasilkan id yang sama. Hal ini penting dua kali di sini, karena setiap kali kamu menekan tombol “Kirim”, aplikasi baru memutar ulang permintaanmu sebelumnya.
Tantangan
MudahBiarkan client menambahkan tugas.
- Di
Program.cs, di bawah list tugas, tambahkan penghitung:var nextId = 4; - Di bagian bawah file, di bawah
TaskItem, deklarasikan bentuk body:record TaskInput(string Title, bool Done); - Petakan
POST /api/tasksdengan parameterTaskInput input. BuatTaskItemdarinextId++,input.Title, daninput.Done, tambahkan ketasks, lalu berikan responsResults.Created($"/api/tasks/{task.Id}", task).
Body { "title": "Order new chairs" } memberikan respons 201 dengan header Location: /api/tasks/4 dan:
{ "id": 4, "title": "Order new chairs", "done": false }Coba: tekan Jalankan, pilih POST, biarkan path /api/tasks, ketik body di atas, lalu tekan Kirim: respons 201 akan muncul, dan tab Headers menampilkan Location: /api/tasks/4. Kirim GET /api/tasks/4: tugas baru akan muncul. Kirim POST yang sama sekali lagi: tugas ini mendapat id 5, karena antrean menjalankan POST pertama lebih dahulu.
Coba sendiri
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);
Semua pelajaran di REST API
1Sumber Daya dan Kata Kerja
Sumber Daya dan URLMembuat dengan POST