Menu
CoddyTech

Odczytywanie treści JSON

Część sekcji Minimal APIs ścieżki ASP.NET Core w Coddy. Lekcja 7 z 20.

Żądanie POST wysyła dane w swoim ciele, zwykle w formacie JSON. Gdy lambda POST przyjmuje parametr będący rekordem, ASP.NET Core odczytuje ciało jako JSON i zapisuje dane w tym parametrze, dopasowując nazwy niezależnie od wielkości liter.

app.MapPost("/notes", (NewNote input) =>
{
    var note = new Note(notes.Count + 1, input.Text);
    notes.Add(note);
    return Results.Created($"/notes/{note.Id}", note);
});

Results.Created zwraca odpowiedź 201 Created — kod statusu dla nowego zasobu — z nagłówkiem Location zawierającym jego adres oraz zasobem w ciele. Wartość niewłaściwego typu, na przykład "text": 5, powoduje odpowiedź 400, zanim zostanie uruchomiona lambda. Właściwość pominięta w JSON otrzymuje wartość domyślną: null lub 0. Na laptopie curl wysyła ciało za pomocą -d; tutaj pasek żądania ma pole Body.

challenge icon

Wyzwanie

Łatwy

Klienci mogą dodawać przepisy. Wysyłają wszystko oprócz identyfikatora, a API wybiera następny identyfikator.

  1. W pliku Recipe.cs dodaj record NewRecipe(string Name, string Category, int Minutes);.
  2. W pliku Program.cs, poniżej listy, dodaj var nextId = 4;.
  3. Mapuj POST /api/recipes. Jego lambda przyjmuje NewRecipe input, tworzy new Recipe(nextId++, input.Name, input.Category, input.Minutes) i dodaje go do recipes.
  4. Zwróć Results.Created($"/api/recipes/{recipe.Id}", recipe).

Wypróbuj: naciśnij „Uruchom”, wybierz POST, wpisz ścieżkę /api/recipes i treść {"name":"Waffles","category":"breakfast","minutes":20}, a następnie naciśnij „Wyślij”. Odpowiedzią jest status 201, a karta Nagłówki pokazuje Location: /api/recipes/4. Wyślij GET /api/recipes/4: Waffles. Każde naciśnięcie „Wyślij” odtwarza wcześniejsze żądania POST w nowej aplikacji, więc przepis nadal tam jest. Wyślij ponownie żądanie POST: identyfikator 5.

Spróbuj swoich sił

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", (string? category) =>
    recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.Run();
quiz iconSprawdź się

Ta lekcja zawiera krótki quiz. Zacznij lekcję, żeby na niego odpowiedzieć i śledzić swoje postępy.

Wszystkie lekcje w sekcji Minimal APIs