Una API mínima asocia una ruta a un manejador, a menudo una lambda: app.MapGet("/products/{id:int}", (int id, IProductStore store) => ...). ASP.NET Core rellena por ti los parámetros del manejador: un parámetro que se llama como un valor de ruta ({id}) lo recibe, los tipos simples que no están en la ruta vienen de la cadena de consulta (?page=2), los servicios registrados vienen de la inyección de dependencias, y un tipo complejo en un POST viene del cuerpo JSON. Una restricción de ruta como {id:int} hace que /products/abc no coincida con ninguna ruta.
El manejador devuelve datos (enviados como JSON con estado 200) o un IResult que fija el estado: Results.Ok(product), Results.NotFound(), Results.Created($"/products/{id}", product) con una cabecera Location, Results.Conflict(), Results.BadRequest() y Results.ValidationProblem(errors) para un 400 con mensajes campo por campo. Acertar con el estado es parte del contrato de la API: los clientes deciden según él.
La entrada se valida antes de usarla. Las anotaciones de datos como [Required] y [Range] (de System.ComponentModel.DataAnnotations) describen las reglas, y Validator.TryValidateObject las comprueba.
Sobre el código de aquí: ASP.NET Core no funciona en este entorno del navegador, así que estos ejercicios usan una pequeña versión sustituta del host de ASP.NET Core, con los mismos nombres y las mismas reglas en todo lo que comprueba esta lección. Es una simplificación: no hay servidor HTTP ni middleware. app.SendAsync(method, url, body) hace de cliente, el JSON usa los mismos nombres en camelCase, y los atributos del tipo [FromBody] no hacen falta ni se admiten. Las anotaciones de datos son las de verdad.
Un GET con un valor de ruta y un POST con un cuerpo JSON, cada uno con un código de estado concreto.