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,3 mil959TypeScriptMITActualizado hace 23 horas
swagger-api/swagger-codegen
Herramienta de línea de comandos que genera SDK de clientes API, esqueletos de servidor y documentación HTML a partir de una definición OpenAPI/Swagger.
- Estrellas
- 17,793
- Forks
- 5,948
- Issues abiertos
- 3,442
- Último commit
- ayer
¿Qué es?
Swagger Codegen es un generador de código basado en plantillas que lee una especificación OpenAPI o Swagger y produce bibliotecas cliente para API, esqueletos de servidor y documentación de API. Evita tener que escribir a mano los modelos de solicitudes y las envolturas de endpoints para cada lenguaje que usa un equipo.
El proyecto admite una larga lista de destinos, incluidos clientes para Java, C#, Go, Python, TypeScript, PHP, Swift, Kotlin, Rust y muchos otros, además de esqueletos de servidor para frameworks como Spring, ASP.NET Core, Flask y Rails. La documentación puede generarse como un archivo HTML estático o como una aplicación HTML dinámica de una sola página. La generación se ejecuta mediante un CLI JAR, Docker o integraciones con los flujos de trabajo de Maven y Gradle.
El proyecto se divide en las líneas de versiones 2.X y 3.X, con distintos IDs de grupo de Maven; OpenAPI 3.0 solo se admite en la línea 3.X. Las plantillas se pueden personalizar para ajustar el resultado o añadir destinos propios.
Funciones clave
- 01Genera clientes API en decenas de lenguajes y frameworks a partir de especificaciones OpenAPI o Swagger.
- 02Produce esqueletos de servidor para frameworks como Spring, ASP.NET Core, Flask y Rails.
- 03Genera documentación de API en HTML estática o dinámica.
- 04Las plantillas se pueden personalizar para cambiar el resultado o añadir nuevos generadores.
- 05Se ejecuta desde un CLI, Docker o flujos de trabajo de Maven y Gradle.
Casos de uso
- Generar un SDK tipado para una API REST interna que consumen varios equipos de clientes.
- Crear esqueletos de servidor a partir de un diseño de API basado en especificaciones.
- Publicar documentación de referencia en HTML a partir de un archivo OpenAPI.
- Crear un cliente de ejemplo de petstore para explorar la estructura del código generado.
Inicio rápido
- 1
Clona el repositorio
git clone https://github.com/swagger-api/swagger-codegen - 2
Entra en el directorio del proyecto
cd swagger-codegen - 3
Compila el proyecto con Maven
mvn clean package - 4
Genera un cliente PHP a partir de la especificación de Petstore
java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate -i https://petstore.swagger.io/v2/swagger.json -l php -o /var/tmp/php_api_client
Antes de usarlo
- Debes compilar desde el código fuente con Java y Maven, lo que requiere trabajo de configuración adicional.
- Las versiones 2.X y 3.X se mantienen por separado con distintos group ID, así que comprueba qué rama necesitas.
Temas
Preguntas frecuentes
- ¿Qué es swagger-codegen?
- Herramienta de línea de comandos que genera SDK de clientes API, esqueletos de servidor y documentación HTML a partir de una definición OpenAPI/Swagger. Swagger Codegen es un generador de código basado en plantillas que lee una especificación OpenAPI o Swagger y produce bibliotecas cliente para API, esqueletos de servidor y documentación de API. Evita tener que escribir a mano los modelos de solicitudes y las envolturas de endpoints para cada lenguaje que usa un equipo.
- ¿swagger-codegen es gratuito? ¿Qué licencia tiene?
- swagger-codegen es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿swagger-codegen sigue mantenido?
- Mantenimiento activo. El último commit de swagger-codegen fue el 22 oct 2026.
- ¿Para qué puedo usar swagger-codegen?
- Generar un SDK tipado para una API REST interna que consumen varios equipos de clientes. Crear esqueletos de servidor a partir de un diseño de API basado en especificaciones. Publicar documentación de referencia en HTML a partir de un archivo OpenAPI. Crear un cliente de ejemplo de petstore para explorar la estructura del código generado.
- ¿Cómo se instala swagger-codegen?
- Clona el repositorio: git clone https://github.com/swagger-api/swagger-codegen Entra en el directorio del proyecto: cd swagger-codegen Compila el proyecto con Maven: mvn clean package Genera un cliente PHP a partir de la especificación de Petstore: java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate -i https://petstore.swagger.io/v2/swagger.json -l php -o /var/tmp/php_api_client
- ¿Dónde consigo swagger-codegen?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/swagger-api/swagger-codegen
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Swagger UI muestra documentación interactiva de API en el navegador a partir de un archivo de especificación OpenAPI/Swagger.
29 mil9,2 milJavaScriptApache-2.0Actualizado hace 23 horas
Genera SDK de cliente, esqueletos de servidor y documentación en decenas de lenguajes y frameworks a partir de especificaciones OpenAPI (v2 y v3).
26,8 mil7,7 milJavaApache-2.0Actualizado ayer
Plugin de protoc que genera un servidor proxy inverso para traducir llamadas HTTP RESTful con JSON en solicitudes gRPC para servicios Go.
20 mil2,4 milGoBSD-3-ClauseActualizado hace 16 horas
Herramienta de código abierto que genera un sitio adaptable de referencia de API, con tres paneles, a partir de definiciones de OpenAPI, Swagger, AsyncAPI o GraphQL.
Herramientas para desarrolladores#api-documentation#openapi#swagger#documentation-generator#asyncapi
26 mil2,4 milTypeScriptMITActualizado hace 23 horas
Cliente de API de código abierto que guarda colecciones como archivos de texto sin formato en el sistema de archivos, una alternativa offline a Postman e Insomnia.
47,8 mil3 milJavaScriptMITActualizado ayer