Menu
CoddyTech

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.

challenge icon

Wyzwanie

Łatwy

Pozwól klientom dodawać zadania.

  1. W pliku Program.cs, poniżej listy zadań, dodaj licznik: var nextId = 4;
  2. Na końcu pliku, poniżej TaskItem, zadeklaruj kształt treści: record TaskInput(string Title, bool Done);
  3. Skonfiguruj POST /api/tasks z parametrem TaskInput input. Utwórz obiekt TaskItem z wartości nextId++, input.Title i input.Done, dodaj go do tasks i 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