Menu
CoddyTech

Tạo mới bằng POST

Thuộc phần REST API trong hành trình ASP.NET Core của Coddy. Bài học 2 trên 20.

POST thêm một mục vào bộ sưu tập. Yêu cầu được gửi đến URL của bộ sưu tập vì client không biết id mới: máy chủ sẽ chọn id đó. Phản hồi là 201 Created, kèm mục mới dưới dạng JSON và một header Location chứa URL của mục mới. Header là một dòng văn bản có tên, được gửi trước phần nội dung.

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);
});

Tham số bản ghi được đọc từ phần nội dung JSON, còn thuộc tính bị thiếu sẽ nhận giá trị mặc định của kiểu dữ liệu đó. Bộ đếm gán id cho từng cuốn sách. Đừng tạo id bằng Random hoặc đồng hồ: cùng một yêu cầu phải luôn tạo ra cùng một id. Ở đây, điều đó càng quan trọng vì mỗi lần nhấn Gửi sẽ phát lại các yêu cầu trước đó trên một ứng dụng mới.

challenge icon

Thử thách

Dễ

Cho phép client thêm công việc.

  1. Trong Program.cs, bên dưới danh sách công việc, thêm một bộ đếm: var nextId = 4;
  2. Ở cuối tệp, bên dưới TaskItem, khai báo cấu trúc phần thân: record TaskInput(string Title, bool Done);
  3. Ánh xạ POST /api/tasks với tham số TaskInput input. Tạo một TaskItem từ nextId++, input.Title và input.Done, thêm nó vào tasks, rồi trả lời bằng Results.Created($"/api/tasks/{task.Id}", task).

Phần thân { "title": "Order new chairs" } trả về 201 cùng tiêu đề Location: /api/tasks/4 và:

{ "id": 4, "title": "Order new chairs", "done": false }

Thử nhé: nhấn Chạy, chọn POST, giữ nguyên đường dẫn /api/tasks, nhập phần thân ở trên rồi nhấn Gửi: 201, và thẻ Headers hiển thị Location: /api/tasks/4. Gửi GET /api/tasks/4: công việc mới. Gửi lại cùng POST: lần này công việc có id 5, vì cột này phát lại POST đầu tiên trước nó.

Tự làm thử

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);

Tất cả bài học trong REST API