Spring Boot 3 + Swagger: Documentando una API REST desde cero

La programación, además de ser funcional, debe ser elegante, limpia y legible. A día de hoy están más de moda que nunca las APIs para crear servicios web o microservicios. Una de las características bien buscadas a lograr en una API es que sea legible y que la podamos probar para poder ver sus entradas y salidas.

Para este escenario cuando desarrollamos en Java el “estándar defacto” se llama Swagger, en el diccionario, cuando buscamos que significa esta palabra refiere a una persona que es admirada por su estilo, forma de ser y por la forma en que habla y actúa.

En este video crearemos un ejemplo completo en el que documentamos una API usando Spring Boot 3 y SpringDoc, una librería construida en el tope de OpenAPI/Swagger.

(Con tu apoyo en Patreon accedes a ventajas exclusivas como directos, preguntas y respuestas en el chat, respuestas a tus dudas y acceso a nuestro libro "Patrones para la implementación de una arquitectura basada en microservicios".

#java #swagger #openapi #javadoc #javadeveloper

[miguelangeldelpinozincke]

Una maravilla encontrar tu canal y aprender con tu contenido. Gracias de cubano a cubano ;)

[jsilva-dev]

Sigo desde hace tiempo tu canal, y eres conciso y directo

[BlaydexX]

Gracias calvito, me salvaste el semestre, besitos en esa frente

[nicolasesteban]

Perfectamente explicado y al grano. Muchas gracias!

[monarcaShadow]

grande me funcionó y se documenta sin necesidad de hacerlo manualmente, ahora estoy revisando la documentación para saber cómo agregar la descripción y demás cosas, para que la documentación sea lo más específica posible

[TheJatabometenabo]

Muchísimas gracias por tu video, ojalá lo hubiese visto antes y me hubiese ahorrado tantas horas de buscar por internet. Saludos!!

[cdspmjc]

excelente, tuve que actualizar spring boot y a su vez, spring doc. Me sirvió muchísimo la info.

[alexanderrepollo]

Espectacular el video, me sirvio mucho! Pero por sobre todo, me ahorro varias horas de estar escribiendo todo el código en Swagger manualmente. Asi que, tienes un nuevo subscriptor y like amigo, saludos desde Buenos Aires!

[AldairG]

Mi hermano un nuevo suscriptor, 10 de 10 este video!! vigente en el 6/02/2024!

[alejandrocabrera]

Exelente pa! agadecido con el de arriba por este canal <3

[ayalatrejoricardo]

muchas gracias por la aportación, muy bien explicado

[IngPedroAraujo]

Ha sido de mucha ayuda el video.. gracias por ello ..

[plataalvaradoemmanuel]

Muy útil la explicación para Spring Boot 3. Muchas gracias!!

[jorgequesada]

Muy buena la explicación. Estaba configurando una app y me estaba dando problemas (supongo que hayan sido de compatibilidad) y con este video resolví el problema. Sigue así. Tienes mi like y susbcripción. Gracias

[juancarloscastrozarate]

Me ayudo bastante tu video, muchas gracias

[munozhoracio]

muy bueno, con el editor de swagger con la meta info de open api podes construir el cliente angular por ejemplo. Pensaba de poder automatizar esta tarea para implmentar alguna libreria automatica sobre los cambio que se poducen en la especificaicon de openAPi

[diegoapestegui]

Excelente la explicación, muy clara. Tienes algún video en el que se explique como agregarle algún tipo de configuración de autenticación ?. Saludos.

[jamartindice]

Hola Sacavix, sabes que estoy sufriendo haces días, no puedo acceder a la url de swagger, acabo de configurar con las dependencias que pasaste y la configuración, y sigo con el mismo problema. No se si estoy eligiendo mal la dependencia.
"Whitelabel Error Page
This application has no explicit mapping for /error, so you are seeing this as a fallback.

Wed May 24 15:02:58 ART 2023
There was an unexpec2ted error (type=Not Found, status=404).
No message available

[germansimba]

genial video, talvez tienes por ahi o puedes hacer un ejemplo de un api rest usando guice, documentando con swagger no lo encuentro por ningun lado

[JimSimRoDev]

Funciona si el proyecto tiene spring security