DEV Community: Romny Duarte

NET9: Swagger no compatible [Alternativas]

Romny Duarte — Mon, 13 Jan 2025 19:56:40 +0000

Hola a Todos.

Continuando con el post anterior en donde mirábamos como desde la versión de NET 8 y NET 9 la configuración para usar Swagger ya no era posible, es este post vengo a comentarles ciertas alternativas para poder resolver esto.

NSwag

Con este paquete, NSWag ofrece la capacidad de crear un cliente como Swagger como Swashbuckle para poder usar tu enpoint.

Lo primero es importar el paquete NSwag.AspNetCore, luego llamaremos a UseSwaggerUi en el archivo Program.cs y le pasamos como parametro el archivo json de la especificacion OpenApi.

Ya con esto solo basta con ir a la ruta /swagger

Algo importante de NSwag es que ofrecen NSwagStudio una solución para trabajar con la especificación OpenApi y generar código C#.

Si te gusta la opción tradicional lo único que tienes que hacer es agregar el paquete Swashbuckle.AspNetCore, el paquete sigue funcionando, pero eventualmente con el tiempo creo que no.

Basta con realizar estas modificaciones

Con esto ya podemos ejecutar nuestra aplicación.

Espero con esto poder ayudarlos.

Sl2

Romny

NET9: Swagger no compatible

Romny Duarte — Mon, 13 Jan 2025 14:59:48 +0000

Hola a Todos.

Desde NET8 y NET9 el componente de Swagger no funciona. Cuando creamos un proyecto viene predefinido habilitar la compatibilidad OpenApi.

Cuando revisamos la configuración del Program.cs observamos lo siguiente.

Si ejecutamos la aplicacion e intentamos navegar por /swagger obtenemos un error 404.

Para validar los endpoints es necesario abrir la ruta /openapi/v1.json

El componente Swagger es utilizado ampliamente en el mundo del desarrollo para realizar pruebas de los endpoints que estamos construyendo, es una herramienta bastante importante y necesaria.

Ahora bien, entonces como hacemos para probar los endpoints, muchos se preguntarán. De primera mano podemos usar Postman, en otra entrada del blog hablaremos de las opciones que tendremos para resolver esto.

En Postman basta con ir a la opción de Import, copiar toda la definición del file /openapi/v1.json. Con esto ya podremos probar nuestros endpoints.

Sl2

Romny

Iniciando nuevamente...

Romny Duarte — Mon, 13 Jan 2025 02:20:25 +0000

Hola a Todos, Mi nombre es Rommy, Ingeniero de sistemas, especialista en Ingeniería del software. Oriundo de Yopal, Casanare (Colombia). Con unos buenos 18 años de experiencia en el desarrollo de software desde aplicaciones de Escritorio, Web Site, App Mobile y como no todo lo relacionado en Cloud.

Los últimos años he trabajado como Arquitecto de Soluciones, enfocado en AWS, pero también con conocimiento en Azure y GCP.

Iniciando nuevamente en los blogs, la plataforma anterior que manejaba Geeks.ms ya dejo de funcionar y bueno perdí mi histórico de blogs que tenía desde el 2018. Si lo quieren consultar lo pueden hacer a través de la plataforma de archive.org Pero bueno, iniciando este 2025 con este nuevo proyecto.

Soy muy fullstack, por ende, comparto de muchos temas. Así que nos vemos en este espacio.

Sl2

Romny
Linkedin