Menu
CoddyTech

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가 반환되어야 합니다. 여기서는 그 점이 특히 두 가지 측면에서 중요합니다. ‘보내기’를 누를 때마다 이전 요청이 새 앱에서 다시 실행되기 때문입니다.

challenge icon

챌린지

쉬움

클라이언트가 작업을 추가할 수 있도록 하세요.

  1. Program.cs에서 작업 목록 아래에 카운터를 추가하세요: var nextId = 4;
  2. 파일 맨 아래에서 TaskItem 아래에 본문의 형태를 선언하세요: record TaskInput(string Title, bool Done);
  3. 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);

REST API의 모든 레슨