Etiqueta: minimal-apis

Una minimal API devuelve 415 cuando el Content-Type de la solicitud no coincide con lo que enlaza el endpoint. Envía Content-Type: application/json para un tipo enlazado desde el cuerpo, o usa [FromForm] para formularios y cargas de archivos.

Llama a AddProblemDetails con un callback CustomizeProblemDetails para reformar el 400 que devuelve la validación integrada de minimal APIs en ASP.NET Core 11: agrega un traceId, reescribe el title, cambia el 400 a 422 o toma el control total con un IProblemDetailsWriter personalizado.

Usa la validación integrada generada por código fuente para reglas síncronas expresables con atributos en ASP.NET Core 11; recurre a FluentValidation cuando necesites reglas asíncronas, lógica compleja entre campos o mantener la validación fuera de tus modelos de dominio.

Una guía completa para estructurar minimal APIs en ASP.NET Core 11 con MapGroup: módulos de endpoints por recurso como métodos de extensión, grupos anidados, filtros y autenticación compartidos, prefijos con parámetros de ruta, etiquetas OpenAPI y las reglas de orden de filtros que sorprenden.

ASP.NET Core 11 trae validación integrada para minimal APIs: llama a AddValidation, anota tu record de solicitud con DataAnnotations y un generador de código fuente valida el modelo enlazado y devuelve 400 ProblemDetails antes de que se ejecute tu handler. Sin controladores, sin FluentValidation, sin comprobaciones manuales.

.NET 11 Preview 4 hace que la generacion de OpenAPI en ASP.NET Core reconozca HTTP QUERY como una operacion de primera clase en OpenAPI 3.2, con un respaldo elegante para documentos 3.0 y 3.1.

Elige minimal APIs por defecto en ASP.NET Core 11. Usa controllers solo cuando necesites características de MVC que minimal APIs todavía no iguala: enrutamiento basado en convenciones para muchas acciones, filtros estilo MVC o vistas Razor.