Etiqueta: minimal-apis

Un Dictionary con [FromForm] en una minimal API se enlaza con prefijo vacío: las claves del formulario deben ser [key], no metadata[key]. Envuélvelo en una clase para conservar nombres legibles.

Olvídate del módulo JS downloadFileFromStream. Renderiza un ancla con el atributo download que apunte a un endpoint de minimal API que devuelva TypedResults.File, o envía por POST un formulario HTML simple con un AntiforgeryToken. Incluye por qué el atributo download es lo que impide que la navegación mejorada de Blazor se trague el clic, por qué data-enhance descarta el archivo en silencio y la trampa de cookies frente a bearer.

En ASP.NET Core 11, devuelve Results<T1, TN> con TypedResults para minimal APIs y ActionResult<T> para controladores. Trata IResult e IActionResult a secas como escotillas de escape: compilan para cualquier respuesta pero no le describen nada a OpenAPI, así que los pagas con atributos ProducesResponseType escritos a mano.

Preview 6 agrega AsyncValidationAttribute e IAsyncValidatableObject para que las reglas de DataAnnotations consulten la base de datos antes de ejecutar tu endpoint, sin bloquear un hilo.

Declara el tipo de retorno del handler como Results<Ok<T>, NotFound> y devuelve TypedResults.Ok / TypedResults.NotFound: la unión ofrece verificación en tiempo de compilación de que el handler solo devuelve lo que declara, y se autodescribe a OpenAPI para que nunca escribas .Produces a mano. Cubre handlers asíncronos, el límite de seis tipos y las pruebas en ASP.NET Core 11.

Guía paso a paso para reemplazar las comprobaciones manuales (if) en los handlers de una minimal API de ASP.NET Core 11 por el validador integrado basado en DataAnnotations y generación de código fuente: qué se rompe, qué reglas manuales se pueden portar y cuáles no, y cómo verificar que el contrato 400 ProblemDetails no cambia.

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.