Tag: minimal-apis

No ASP.NET Core 11, retorne Results<T1, TN> com TypedResults para minimal APIs e ActionResult<T> para controllers. Trate IResult puro e IActionResult puro como saídas de emergência: eles compilam para qualquer resposta, mas não descrevem nada ao OpenAPI, então você paga por isso em atributos ProducesResponseType escritos à mão.

O Preview 6 adiciona AsyncValidationAttribute e IAsyncValidatableObject para que as regras de DataAnnotations consultem o banco de dados antes de o seu endpoint rodar, sem bloquear uma thread.

Declare o tipo de retorno do handler como Results<Ok<T>, NotFound> e retorne TypedResults.Ok / TypedResults.NotFound: a união oferece verificação em tempo de compilação de que o handler só retorna o que declara, e ela se autodescreve ao OpenAPI para que você nunca escreva .Produces na mão. Cobre handlers assíncronos, o limite de seis tipos e testes no ASP.NET Core 11.

Guia passo a passo para substituir verificações manuais (if) nos handlers de uma minimal API do ASP.NET Core 11 pelo validador integrado baseado em DataAnnotations e geração de código-fonte: o que quebra, quais regras manuais dá para portar e quais não, e como verificar que o contrato 400 ProblemDetails continua idêntico.

Uma minimal API retorna 415 quando o Content-Type da requisição não corresponde ao que o endpoint faz o binding. Envie Content-Type: application/json para um tipo vinculado ao corpo, ou use [FromForm] para formulários e uploads de arquivos.

Chame AddProblemDetails com um callback CustomizeProblemDetails para remodelar o 400 que a validação embutida de minimal APIs retorna no ASP.NET Core 11: adicione um traceId, reescreva o title, troque 400 por 422, ou assuma o controle total com um IProblemDetailsWriter personalizado.

Use a validação integrada gerada por código-fonte para regras síncronas expressáveis por atributos no ASP.NET Core 11; recorra ao FluentValidation quando precisar de regras assíncronas, lógica complexa entre campos ou manter a validação fora dos seus modelos de domínio.

Um guia completo para estruturar minimal APIs no ASP.NET Core 11 com MapGroup: módulos de endpoints por recurso como métodos de extensão, grupos aninhados, filtros e autenticação compartilhados, prefixos com parâmetros de rota, tags OpenAPI e as regras de ordem de filtros que surpreendem.

O ASP.NET Core 11 traz validação integrada para minimal APIs: chame AddValidation, anote seu record de requisição com DataAnnotations e um gerador de código-fonte valida o modelo vinculado e retorna 400 ProblemDetails antes de o seu handler rodar. Sem controllers, sem FluentValidation, sem verificações manuais.

O .NET 11 Preview 4 faz a geracao de OpenAPI no ASP.NET Core reconhecer o HTTP QUERY como uma operacao de primeira classe no OpenAPI 3.2, com um fallback elegante para documentos 3.0 e 3.1.