Framework web de Python para crear API REST con anotaciones de tipos sobre Django, documentación OpenAPI automática y validación con Pydantic.
9,2 mil+8 esta semana627PythonMITActualizado hace 10 horas
springdoc/springdoc-openapi
Genera documentación OpenAPI 3 y páginas de Swagger UI o Scalar para aplicaciones Spring Boot al inspeccionar los controladores en tiempo de ejecución.
Alternativa open source a:SpringFox
- Estrellas
- 3,746
- Forks
- 612
- Issues abiertos
- 3
- Último commit
- hace 15 horas
¿Qué es?
springdoc-openapi es una biblioteca Java para aplicaciones Spring Boot que inspecciona en tiempo de ejecución los controladores, la configuración, las anotaciones de validación y las restricciones de Bean Validation. Genera una descripción OpenAPI 3, disponible en JSON y YAML, junto con una página interactiva de Swagger UI o Scalar. Basta con añadir una dependencia starter para empezar, sin necesidad de configuración adicional.
La biblioteca es compatible con Spring Web MVC y Spring WebFlux, incluidos los endpoints funcionales, y se integra con Spring Security, OAuth 2, Spring Data REST, Spring HATEOAS y Actuator. También admite Kotlin, Groovy y Javadoc, y puede exponer una API como herramientas para agentes de IA mediante MCP. Los plugins de Maven y Gradle pueden generar la descripción durante la compilación, y se admiten las imágenes nativas de GraalVM.
El proyecto está dirigido a Spring Boot 4.x en Java 17 o posterior. La línea 2.x se mantiene para Spring Boot 3, y la versión 1.x ya no cuenta con soporte de código abierto.
Funciones clave
- 01Genera descripciones OpenAPI 3 en JSON y YAML en tiempo de ejecución a partir del código de Spring Boot.
- 02Ofrece páginas de Swagger UI o Scalar para explorar la API.
- 03Es compatible con Spring Web MVC, WebFlux y los endpoints funcionales.
- 04Se integra con Spring Security, OAuth 2, Spring Data REST y HATEOAS.
- 05Lee anotaciones de Bean Validation como @NotNull, @Min, @Max y @Size.
- 06Incluye plugins de Maven y Gradle para generar la descripción durante la compilación.
Casos de uso
- Documentar una API REST creada con Spring Boot sin escribir el archivo OpenAPI manualmente.
- Ofrecer a los equipos de frontend o externos una página interactiva para probar los endpoints.
- Exponer una API de Spring como herramientas para agentes de IA mediante MCP.
- Generar un archivo OpenAPI durante la compilación para crear código cliente o comprobar contratos.
En colecciones
Temas
#java#spring-boot#openapi#swagger-ui#rest-api#api-documentation#json-format#kotlin#oauth2#openapi-spec
Preguntas frecuentes
- ¿Qué es springdoc-openapi?
- Genera documentación OpenAPI 3 y páginas de Swagger UI o Scalar para aplicaciones Spring Boot al inspeccionar los controladores en tiempo de ejecución. springdoc-openapi es una biblioteca Java para aplicaciones Spring Boot que inspecciona en tiempo de ejecución los controladores, la configuración, las anotaciones de validación y las restricciones de Bean Validation. Genera una descripción OpenAPI 3, disponible en JSON y YAML, junto con una página interactiva de Swagger UI o Scalar. Basta con añadir una dependencia starter para empezar, sin necesidad de configuración adicional.
- ¿springdoc-openapi es gratuito? ¿Qué licencia tiene?
- springdoc-openapi es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿springdoc-openapi sigue mantenido?
- Mantenimiento activo. El último commit de springdoc-openapi fue el 6 nov 2026.
- ¿Para qué puedo usar springdoc-openapi?
- Documentar una API REST creada con Spring Boot sin escribir el archivo OpenAPI manualmente. Ofrecer a los equipos de frontend o externos una página interactiva para probar los endpoints. Exponer una API de Spring como herramientas para agentes de IA mediante MCP. Generar un archivo OpenAPI durante la compilación para crear código cliente o comprobar contratos.
- ¿Dónde consigo springdoc-openapi?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/springdoc/springdoc-openapi
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Biblioteca Java que genera especificaciones OpenAPI a partir de anotaciones del código y API REST de JAX-RS, con compatibilidad con OpenAPI 3.x.
7,5 mil+3 esta semana2,3 milJavaApache-2.0Bien mantenidoActualizado ayer
Genera especificaciones Swagger/OpenAPI 2.0 reales y documentación interactiva a partir de APIs de Django REST Framework.
3,5 mil+2 esta semana439PythonOtherActualizado hace 28 días
Swagger UI muestra documentación interactiva de API en el navegador a partir de un archivo de especificación OpenAPI/Swagger.
29,1 mil+11 esta semana9,2 milJavaScriptApache-2.0Actualizado hace 7 horas
Kit de herramientas OpenAPI/Swagger de código abierto con una referencia interactiva de API, un cliente de API offline-first e integraciones para numerosos frameworks web.
16,4 mil+31 esta semana966TypeScriptMITActualizado hace 6 horas
Herramienta de Go que genera documentación de API Swagger 2.0 a partir de anotaciones en los comentarios del código fuente de Go.
13 mil1,5 milGoMITActualizado el mes pasado