Documentación API con Swagger/OpenAPI
OpenAPI (anteriormente Swagger) es el estándar de la industria para describir las API REST. La biblioteca springdoc-openapi genera automáticamente una especificación OpenAPI 3.0 JSON/YAML desde sus controladores Spring MVC y ofrece una interfaz de usuario Swagger interactiva en /swagger-ui.html, sin configuración. Las anotaciones le permiten enriquecer los documentos generados con descripciones, ejemplos y esquemas de seguridad.