Menu
CoddyTech

Ungültige Eingaben zurückweisen

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

Ein Body kann gebunden werden und trotzdem keinen Sinn ergeben: eine leere E-Mail-Adresse, ein negativer Preis. Antworte mit 400 Bad Request und gib an, was falsch ist – in einer Form, die Clients lesen können. Results.ValidationProblem erwartet ein Dictionary, das Feldnamen Nachrichten zuordnet:

if (string.IsNullOrWhiteSpace(input.Email))
{
    return Results.ValidationProblem(new Dictionary<string, string[]>
    {
        ["email"] = ["Email is required."],
    });
}

Die Antwort lautet 400, hat den Content-Type application/problem+json und diesen Body:

{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": { "email": ["Email is required."] } }

Prüfe alles, bevor du etwas änderst, damit eine abgelehnte Anfrage die Daten unverändert lässt. Ein Body, der kein gültiges JSON ist, erreicht deine Lambda-Funktion nie: ASP.NET Core antwortet darauf mit 400.

challenge icon

Aufgabe

Einfach

Derzeit fügt POST /api/tasks mit { "title": "" } eine Aufgabe ohne Titel hinzu. Weise das zurück.

  1. Prüfe am Anfang der POST /api/tasks-Lambda, vor nextId++, den Titel mit string.IsNullOrWhiteSpace(input.Title). Damit werden ein fehlender Titel (null), ein leerer Titel und ein nur aus Leerzeichen bestehender Titel erfasst.
  2. Wenn die Prüfung fehlschlägt, antworte mit Results.ValidationProblem, dem Feld title und der Nachricht Title is required., sodass der Body Folgendes enthält:
    "errors": { "title": ["Title is required."] }
  3. Füge dieselbe Prüfung am Anfang der PUT /api/tasks/{id:int}-Lambda hinzu.

Probiere es aus: Klicke auf „Ausführen“ und sende POST mit { "title": "" } an /api/tasks: 400 und die oben aufgeführten Fehler. Sende GET /api/tasks: weiterhin drei Aufgaben. Sende PUT mit { "title": " ", "done": true } an /api/tasks/1: 400, und Aufgabe 1 behält ihren Titel. Sende POST mit { "title": "Order new chairs" }: 201 mit der ID 4.

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),
};
var nextId = 4;

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.MapPost("/api/tasks", (TaskInput input) =>
{
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    var task = tasks[index];
    tasks[index] = task with
    {
        Title = patch.Title ?? task.Title,
        Done = patch.Done ?? task.Done,
    };
    return Results.Ok(tasks[index]);
});

app.MapDelete("/api/tasks/{id:int}", (int id) =>
{
    var removed = tasks.RemoveAll(t => t.Id == id);
    return removed == 0 ? Results.NotFound() : Results.NoContent();
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
record TaskPatch(string? Title, bool? Done);
quiz iconTeste dich selbst

Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.

Alle Lektionen in REST-APIs