Etiqueta: openapi

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.

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.

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

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

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.

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.