Uma API mínima associa uma rota a um manipulador, geralmente uma lambda: app.MapGet("/products/{id:int}", (int id, IProductStore store) => ...). O ASP.NET Core preenche os parâmetros do manipulador para você: um parâmetro com o mesmo nome de um valor de rota ({id}) recebe esse valor, tipos simples que não estão na rota vêm da query string (?page=2), os serviços registrados vêm da injeção de dependência, e um tipo complexo em um POST vem do corpo JSON. Uma restrição de rota como {id:int} faz com que /products/abc não corresponda a nenhuma rota.
O manipulador retorna dados (enviados como JSON com status 200) ou um IResult que define o status: Results.Ok(product), Results.NotFound(), Results.Created($"/products/{id}", product) com um cabeçalho Location, Results.Conflict(), Results.BadRequest() e Results.ValidationProblem(errors) para um 400 com mensagens campo a campo. Acertar o status faz parte do contrato da API: os clientes tomam decisões com base nele.
A entrada é validada antes de ser usada. Anotações de dados como [Required] e [Range] (de System.ComponentModel.DataAnnotations) descrevem as regras, e Validator.TryValidateObject as verifica.
Sobre o código daqui: o ASP.NET Core não roda neste ambiente de navegador, então estes exercícios usam um pequeno substituto do host do ASP.NET Core, com os mesmos nomes e as mesmas regras em tudo o que esta lição verifica. É uma simplificação: não há servidor HTTP nem middleware. app.SendAsync(method, url, body) faz o papel de cliente, o JSON usa os mesmos nomes em camelCase, e atributos do tipo [FromBody] não são necessários nem aceitos. As anotações de dados são as de verdade.
Um GET com um valor de rota e um POST com um corpo JSON, cada um com um código de status específico.