POST로 생성하기
Coddy ASP.NET Core 여정의 REST API 섹션에 포함된 레슨. 20개 중 2번째.
POST는 컬렉션에 항목을 추가합니다. 클라이언트는 새 id를 모르므로 컬렉션의 URL로 요청을 보냅니다. id는 서버가 정하기 때문입니다. 응답은 새 항목을 JSON으로 포함하고 새 항목의 URL이 담긴 Location 헤더를 포함하는 201 Created입니다. 헤더는 본문보다 먼저 전송되는 이름이 지정된 텍스트 줄입니다.
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 본문에서 읽으며, 누락된 속성에는 해당 형식의 기본값이 지정됩니다. 카운터를 사용해 각 책에 id를 부여합니다. Random이나 시계를 사용해 id를 만들지 마세요. 같은 요청에는 항상 같은 id가 반환되어야 합니다. 여기서는 그 점이 특히 두 가지 측면에서 중요합니다. ‘보내기’를 누를 때마다 이전 요청이 새 앱에서 다시 실행되기 때문입니다.
챌린지
쉬움클라이언트가 작업을 추가할 수 있도록 하세요.
Program.cs에서 작업 목록 아래에 카운터를 추가하세요:var nextId = 4;- 파일 맨 아래에서
TaskItem아래에 본문의 형태를 선언하세요:record TaskInput(string Title, bool Done); TaskInput input매개변수를 사용해POST /api/tasks를 매핑하세요.nextId++,input.Title,input.Done으로TaskItem을 만들고,tasks에 추가한 다음Results.Created($"/api/tasks/{task.Id}", task)를 반환하세요.
본문 { "title": "Order new chairs" }은 헤더 Location: /api/tasks/4와 다음 내용을 포함해 201을 반환합니다:
{ "id": 4, "title": "Order new chairs", "done": false }직접 해 보세요: ‘실행’을 누르고 POST를 선택한 다음 경로 /api/tasks는 그대로 두고, 위의 본문을 입력한 뒤 ‘보내기’를 누르세요. 201이 반환되고 Headers 탭에 Location: /api/tasks/4가 표시됩니다. GET /api/tasks/4를 보내면 새 작업을 확인할 수 있습니다. 같은 POST를 다시 보내면 이 작업의 id는 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);