Etiqueta: openapi

Swashbuckle 8 y posteriores emiten openapi 3.0.4, no 3.0.1, y no existe un OpenApiSpecVersion para versiones de parche. Por qué cambió y cuatro formas de fijar la cadena que espera tu herramienta.

ASP.NET Core 11 emite openapi 3.2.0 por defecto y Swagger UI por debajo de 10.1.5 lo rechaza. Actualiza Swashbuckle.AspNetCore.SwaggerUI o fija OpenApiVersion en OpenApi3_1.

Scalar envía 1.02 MiB de JavaScript comprimido con gzip y un constructor de solicitudes mucho mejor. Swagger UI envía 514 KiB y renderiza OpenAPI 3.2, que es lo que .NET 11 ya emite por defecto. Payloads medidos, la brecha de 3.2, enrutamiento por endpoints en ambos lados y los detalles de autenticación que deciden.

CS9137 viene del generador de código fuente de Microsoft.AspNetCore.OpenApi. Agrega InterceptorsNamespaces a cada proyecto que llame a AddOpenApi, no solo al que tiene el PackageReference.

OpenApiReference se eliminó en Microsoft.OpenApi 2.0. Cambiar el using a Microsoft.OpenApi no basta: reemplaza cada uso por una referencia tipada como OpenApiSchemaReference.

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.

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.

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.

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.

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.