Tworzenie za pomocą POST
Część sekcji API REST ścieżki ASP.NET Core w Coddy. Lekcja 2 z 20.
POST dodaje element do kolekcji. Żądanie trafia pod adres URL kolekcji, ponieważ klient nie zna nowego identyfikatora: wybiera go serwer. Odpowiedzią jest 201 Created, z nowym elementem w formacie JSON i nagłówkiem Location, który zawiera adres URL nowego elementu. Nagłówek to nazwana linia tekstu wysyłana przed treścią.
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);
});Parametr rekordu jest odczytywany z treści JSON, a brakująca właściwość otrzymuje wartość domyślną swojego typu. Licznik nadaje każdej książce identyfikator. Nigdy nie twórz identyfikatorów za pomocą Random ani zegara: te same żądania muszą dawać te same identyfikatory. Tutaj ma to podwójne znaczenie, ponieważ każde kliknięcie „Wyślij” odtwarza wcześniejsze żądania w nowej instancji aplikacji.
Wyzwanie
ŁatwyPozwól klientom dodawać zadania.
- W pliku
Program.cs, poniżej listy zadań, dodaj licznik:var nextId = 4; - Na końcu pliku, poniżej
TaskItem, zadeklaruj kształt treści:record TaskInput(string Title, bool Done); - Skonfiguruj
POST /api/tasksz parametremTaskInput input. Utwórz obiektTaskItemz wartościnextId++,input.Titleiinput.Done, dodaj go dotasksi zwróćResults.Created($"/api/tasks/{task.Id}", task).
Treść { "title": "Order new chairs" } zwraca status 201 z nagłówkiem Location: /api/tasks/4 i:
{ "id": 4, "title": "Order new chairs", "done": false }Wypróbuj: naciśnij „Uruchom”, wybierz POST, pozostaw ścieżkę /api/tasks, wpisz powyższą treść i naciśnij „Wyślij”: status 201, a karta Headers pokazuje Location: /api/tasks/4. Wyślij GET /api/tasks/4: pojawi się nowe zadanie. Wyślij ponownie to samo żądanie POST: tym razem zadanie otrzyma id 5, ponieważ kolumna odtwarza przed nim pierwsze żądanie POST.
Spróbuj swoich sił
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);
Wszystkie lekcje w sekcji API REST
1Zasoby i metody HTTP
Zasoby i adresy URLTworzenie za pomocą POST