Start Debugging

Etiqueta: openapi

10 posts

2026-08-09 csharp dotnet dotnet-11

Cómo servir documentación OpenAPI con Scalar en lugar de Swagger UI en ASP.NET Core 11

Reemplaza UseSwaggerUI por MapScalarApiReference en ASP.NET Core 11: enrutamiento, múltiples documentos, autenticación precargada, control en producción, recursos sin CDN y las extensiones de OpenAPI exclusivas de Scalar.

2026-07-24 migration swashbuckle openapi

Migrar IOperationFilter e ISchemaFilter de Swashbuckle a transformadores de OpenAPI en .NET 11

Una referencia de migración filtro por filtro para pasar el código de IOperationFilter e ISchemaFilter de Swashbuckle a los transformadores de operación y esquema integrados en .NET 11, con el mapeo de los objetos de contexto y los cambios de Microsoft.OpenApi v2 que rompen la compilación.

2026-07-14 csharp dotnet dotnet-11

Cómo devolver una unión tipada Results<T1, T2> desde un endpoint de minimal API en ASP.NET Core 11

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.

2026-07-12 csharp dotnet dotnet-11

Cómo personalizar el documento OpenAPI con AddOperationTransformer y AddSchemaTransformer en ASP.NET Core 11

Un análisis a fondo del pipeline de transformadores de OpenAPI integrado en .NET 11: transformadores de operación vs. de esquema, los objetos de contexto, el orden de ejecución, los transformadores activados por DI, y recetas para encabezados, respuestas, ejemplos y ajustes por propiedad.

2026-06-16 migration swashbuckle openapi

Migrar de Swashbuckle al generador de OpenAPI integrado en .NET 11

Una migración paso a paso de Swashbuckle.AspNetCore a Microsoft.AspNetCore.OpenApi en .NET 11: cambiar AddSwaggerGen por AddOpenApi, convertir los filtros de operación, esquema y documento en transformadores, mantener una UI y los cambios incompatibles de Microsoft.OpenApi v2 que muerden.

2026-06-08 csharp dotnet dotnet-11

Cómo exponer OpenAPI sin Swashbuckle en ASP.NET Core 11

Swashbuckle ya no está en las plantillas de ASP.NET Core. Así se genera y se sirve un documento OpenAPI en .NET 11 con el paquete integrado Microsoft.AspNetCore.OpenApi: AddOpenApi, MapOpenApi, transformadores, varios documentos, generación en tiempo de compilación y una interfaz encima.

2026-05-24 dotnet-11 aspnetcore openapi

ASP.NET Core en .NET 11 Preview 4 le ensena a OpenAPI el metodo HTTP QUERY

.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.

2026-04-28 dotnet-10 aspnetcore openapi

Asp.Versioning 10.0 por fin se lleva bien con el OpenAPI integrado en .NET 10

Asp.Versioning 10.0 es la primera versión que apunta a .NET 10 y al nuevo pipeline de Microsoft.AspNetCore.OpenApi. La guía del 23 de abril de Sander ten Brinke muestra cómo registrar un documento OpenAPI por cada versión de la API con WithDocumentPerVersion().

2026-04-28 aspnetcore openapi swagger

Cómo agregar flujos de autenticación de OpenAPI a Swagger UI en .NET 11

En .NET 11 el documento OpenAPI lo genera Microsoft.AspNetCore.OpenApi y Swagger UI ya no viene en la plantilla. Así se conectan Bearer, OAuth2 con PKCE y OpenID Connect para que el botón Authorize realmente funcione.

2026-04-24 dotnet dotnet-11 csharp

Cómo generar código cliente fuertemente tipado desde una especificación OpenAPI en .NET 11

Usa Kiota, el generador oficial de OpenAPI de Microsoft, para producir un cliente C# fluent y fuertemente tipado desde cualquier especificación OpenAPI. Paso a paso: instalar, generar, conectar a la inyección de dependencias de ASP.NET Core y gestionar la autenticación.