Создание с помощью 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 или часов: одинаковые запросы должны давать одинаковые идентификаторы. Здесь это важно вдвойне, потому что каждое нажатие «Отправить» повторно выполняет все предыдущие запросы в новом экземпляре приложения.
Задание
ЛегкоПозвольте клиентам добавлять задачи.
- В
Program.cs, ниже списка задач, добавьте счётчик:var nextId = 4; - В конце файла, ниже
TaskItem, объявите структуру тела запроса:record TaskInput(string Title, bool Done); - Сопоставьте
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
1Ресурсы и HTTP-методы
Ресурсы и URLСоздание с помощью POST