Menu
CoddyTech

Создание с помощью POST

Часть раздела REST API путешествия по ASP.NET Core на Coddy. Урок 2 из 20.

POST добавляет элемент в коллекцию. Запрос отправляется на URL коллекции, потому что клиент не знает новый идентификатор: его выбирает сервер. Ответ — 201 Created, с новым элементом в формате JSON и заголовком Location, в котором указан URL нового элемента. Заголовок — это именованная строка текста, отправляемая перед телом.

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, а отсутствующее свойство получает значение по умолчанию для своего типа. Счётчик присваивает каждой книге свой идентификатор. Никогда не создавай идентификаторы с помощью Random или часов: одинаковые запросы должны давать одинаковые идентификаторы. Здесь это важно вдвойне, потому что каждое нажатие «Отправить» повторно выполняет все предыдущие запросы в новом экземпляре приложения.

challenge icon

Задание

Легко

Позвольте клиентам добавлять задачи.

  1. В Program.cs, ниже списка задач, добавьте счётчик: var nextId = 4;
  2. В конце файла, ниже TaskItem, объявите структуру тела запроса: record TaskInput(string Title, bool Done);
  3. Сопоставьте POST /api/tasks с параметром TaskInput input. Создайте TaskItem из nextId++, input.Title и input.Done, добавьте его в tasks и верните Results.Created($"/api/tasks/{task.Id}", task).

Тело { "title": "Order new chairs" } возвращает ответ 201 с заголовком Location: /api/tasks/4 и таким содержимым:

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

Попробуйте: нажмите «Запустить», выберите POST, оставьте путь /api/tasks, введите тело запроса выше и нажмите «Отправить»: ответ будет 201, а на вкладке «Заголовки» появится 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