Menu
CoddyTech

Erstellen mit POST

Teil des Abschnitts REST-APIs der ASP.NET Core-Journey von Coddy. Lektion 2 von 20.

POST fügt einer Sammlung ein Element hinzu. Die Anfrage geht an die URL der Sammlung, da der Client die neue ID nicht kennt: Der Server legt sie fest. Die Antwort lautet 201 Created und enthält das neue Element als JSON sowie einen Location-Header, der die URL des neuen Elements enthält. Ein Header ist eine benannte Textzeile, die vor dem Body gesendet wird.

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);
});

Der Parameter des Records wird aus dem JSON-Body gelesen, und eine fehlende Eigenschaft erhält den Standardwert ihres Typs. Ein Zähler weist jedem Buch seine ID zu. Erzeuge IDs niemals mit Random oder der Uhr: Dieselben Anfragen müssen dieselben IDs ergeben. Hier ist das gleich aus zwei Gründen wichtig, denn bei jedem Klick auf „Senden“ werden deine vorherigen Anfragen in einer neuen App erneut ausgeführt.

challenge icon

Aufgabe

Einfach

Ermögliche Clients, Aufgaben hinzuzufügen.

  1. Füge in Program.cs unterhalb der Aufgabenliste einen Zähler hinzu: var nextId = 4;
  2. Deklariere am Ende der Datei, unterhalb von TaskItem, die Form des Request-Bodys: record TaskInput(string Title, bool Done);
  3. Binde POST /api/tasks mit einem Parameter TaskInput input ein. Erstelle aus nextId++, input.Title und input.Done ein TaskItem, füge es zu tasks hinzu und antworte mit Results.Created($"/api/tasks/{task.Id}", task).

Der Request-Body { "title": "Order new chairs" } liefert eine Antwort mit Statuscode 201, dem Header Location: /api/tasks/4 und:

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

Probier es aus: Drücke auf „Ausführen“, wähle POST, behalte den Pfad /api/tasks bei, gib den obigen Request-Body ein und drücke auf „Senden“: 201. Im Tab „Headers“ wird Location: /api/tasks/4 angezeigt. Sende GET /api/tasks/4: die neue Aufgabe. Sende denselben POST noch einmal: Dieser erhält die ID 5, weil die Spalte den ersten POST davor erneut abspielt.

Probier es selbst

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);

Alle Lektionen in REST-APIs