Lire un corps JSON
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 7 sur 20.
Une requête POST envoie des données dans son corps, généralement au format JSON. Lorsqu’une lambda POST prend un paramètre de type enregistrement, ASP.NET Core lit le corps au format JSON et y associe les noms sans tenir compte de la casse.
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 renvoie le statut 201 Created, utilisé pour une nouvelle ressource, avec un en-tête Location contenant son adresse et la ressource dans le corps. Une valeur de type incorrect, comme "text": 5, renvoie le statut 400 avant l’exécution de la lambda. Une propriété absente du JSON reçoit sa valeur par défaut : null ou 0. Sur un ordinateur portable, curl envoie un corps avec -d ; ici, la barre de requête comporte une zone Body.
Défi
FacileLes clients peuvent ajouter des recettes. Ils envoient tout sauf l’identifiant, et l’API choisit l’identifiant suivant.
- Dans
Recipe.cs, ajouterecord NewRecipe(string Name, string Category, int Minutes);. - Dans
Program.cs, sous la liste, ajoutevar nextId = 4;. - Associe
POST /api/recipes. Sa lambda prendNewRecipe input, créenew Recipe(nextId++, input.Name, input.Category, input.Minutes)et l’ajoute àrecipes. - Renvoie
Results.Created($"/api/recipes/{recipe.Id}", recipe).
Essaie : appuie sur Exécuter, choisis POST, saisis le chemin /api/recipes et le corps {"name":"Waffles","category":"breakfast","minutes":20}, puis clique sur Envoyer. La réponse a le statut 201 avec {"id":4,"name":"Waffles","category":"breakfast","minutes":20}, et l’onglet Headers affiche Location: /api/recipes/4. Envoie GET /api/recipes/4 : Waffles. Chaque clic sur Envoyer rejoue tes requêtes POST précédentes dans une nouvelle application, donc la recette est toujours là. Envoie à nouveau la requête POST : identifiant 5.
Essayez vous-même
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();
Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.
Toutes les leçons de Minimal APIs
2Résultats et corps JSON
OK et introuvable