NOTA: Si está buscando Swagger Core 1.5.X y OpenAPI 2.0, consulte la rama 1.5.
NOTA: Desde la versión 2.1.7, Swagger Core también admite el espacio de nombres Jakarta. Hay un conjunto paralelo de artefactos con el sufijo -jakarta
, que proporciona la misma funcionalidad que los artefactos sin sufijo (es decir, javax
). Consulte la Wiki para obtener más detalles.
NOTA: Desde la versión 2.2.0, Swagger Core es compatible con OpenAPI 3.1; vea esta página para más detalles
Swagger Core es una implementación Java de la especificación OpenAPI. La versión actual es compatible con JAX-RS2 (espacios de nombres javax
y jakarta
).
Consulte la guía sobre cómo comenzar con Swagger Core para comenzar a agregar Swagger a su API.
La wiki de github contiene documentación, ejemplos, contribuciones, etc. Empiece por ahí.
La especificación OpenAPI ha pasado por varias revisiones desde su creación inicial en 2010. El proyecto Swagger Core tiene las siguientes compatibilidades con la especificación OpenAPI:
Versión central Swagger | Fecha de lanzamiento | Compatibilidad con especificaciones OpenAPI | Notas | Estado |
---|---|---|---|---|
2.2.26 ( estable actual ) | 2024-11-18 | 3.x | etiqueta v2.2.26 | Apoyado |
2.2.25 | 2024-10-02 | 3.x | etiqueta v2.2.25 | Apoyado |
2.2.24 | 2024-09-23 | 3.x | etiqueta v2.2.24 | Apoyado |
2.2.23 | 2024-08-28 | 3.x | etiqueta v2.2.23 | Apoyado |
2.2.22 | 2024-05-15 | 3.x | etiqueta v2.2.22 | Apoyado |
2.2.21 | 2024-03-20 | 3.x | etiqueta v2.2.21 | Apoyado |
2.2.20 | 2023-12-19 | 3.x | etiqueta v2.2.20 | Apoyado |
2.2.19 | 2023-11-10 | 3.x | etiqueta v2.2.19 | Apoyado |
2.2.18 | 2023-10-25 | 3.x | etiqueta v2.2.18 | Apoyado |
2.2.17 | 2023-10-12 | 3.x | etiqueta v2.2.17 | Apoyado |
2.2.16 | 2023-09-18 | 3.x | etiqueta v2.2.16 | Apoyado |
2.2.15 | 2023-07-08 | 3.x | etiqueta v2.2.15 | Apoyado |
2.2.14 | 2023-06-26 | 3.x | etiqueta v2.2.14 | Apoyado |
2.2.13 | 2023-06-24 | 3.x | etiqueta v2.2.13 | Apoyado |
2.2.12 | 2023-06-13 | 3.x | etiqueta v2.2.12 | Apoyado |
2.2.11 | 2023-06-01 | 3.x | etiqueta v2.2.11 | Apoyado |
2.2.10 | 2023-05-15 | 3.x | etiqueta v2.2.10 | Apoyado |
2.2.9 | 2023-03-20 | 3.x | etiqueta v2.2.9 | Apoyado |
2.2.8 | 2023-01-06 | 3.x | etiqueta v2.2.8 | Apoyado |
2.2.7 | 2022-11-15 | 3.0 | etiqueta v2.2.7 | Apoyado |
2.2.6 | 2022-11-02 | 3.0 | etiqueta v2.2.6 | Apoyado |
2.2.5 | 2022-11-02 | 3.0 | etiqueta v2.2.5 | Apoyado |
2.2.4 | 2022-10-16 | 3.0 | etiqueta v2.2.4 | Apoyado |
2.2.3 | 2022-09-27 | 3.0 | etiqueta v2.2.3 | Apoyado |
2.2.2 | 2022-07-20 | 3.0 | etiqueta v2.2.2 | Apoyado |
2.2.1 | 2022-06-15 | 3.0 | etiqueta v2.2.1 | Apoyado |
2.2.0 | 2022-04-04 | 3.0 | etiqueta v2.2.0 | Apoyado |
2.1.13 | 2022-02-07 | 3.0 | etiqueta v2.1.13 | Apoyado |
2.1.12 | 2021-12-23 | 3.0 | etiqueta v2.1.12 | Apoyado |
2.1.11 | 2021-09-29 | 3.0 | etiqueta v2.1.11 | Apoyado |
2.1.10 | 2021-06-28 | 3.0 | etiqueta v2.1.10 | Apoyado |
2.1.9 | 2021-04-20 | 3.0 | etiqueta v2.1.9 | Apoyado |
2.1.8 | 2021-04-18 | 3.0 | etiqueta v2.1.8 | Apoyado |
2.1.7 | 2021-02-18 | 3.0 | etiqueta v2.1.7 | Apoyado |
2.1.6 | 2020-12-04 | 3.0 | etiqueta v2.1.6 | Apoyado |
2.1.5 | 2020-10-01 | 3.0 | etiqueta v2.1.5 | Apoyado |
2.1.4 | 2020-07-24 | 3.0 | etiqueta v2.1.4 | Apoyado |
2.1.3 | 2020-06-27 | 3.0 | etiqueta v2.1.3 | Apoyado |
2.1.2 | 2020-04-01 | 3.0 | etiqueta v2.1.2 | Apoyado |
2.1.1 | 2020-01-02 | 3.0 | etiqueta v2.1.1 | Apoyado |
2.1.0 | 2019-11-16 | 3.0 | etiqueta v2.1.0 | Apoyado |
2.0.10 | 2019-10-11 | 3.0 | etiqueta v2.0.10 | Apoyado |
2.0.9 | 2019-08-22 | 3.0 | etiqueta v2.0.9 | Apoyado |
2.0.8 | 2019-04-24 | 3.0 | etiqueta v2.0.8 | Apoyado |
2.0.7 | 2019-02-18 | 3.0 | etiqueta v2.0.7 | Apoyado |
2.0.6 | 2018-11-27 | 3.0 | etiqueta v2.0.6 | Apoyado |
2.0.5 | 2018-09-19 | 3.0 | etiqueta v2.0.5 | Apoyado |
2.0.4 | 2018-09-05 | 3.0 | etiqueta v2.0.4 | Apoyado |
2.0.3 | 2018-08-09 | 3.0 | etiqueta v2.0.3 | Apoyado |
1.6.14 ( estable actual ) | 2024-03-19 | 2.0 | etiqueta v1.6.14 | Apoyado |
1.6.13 | 2024-01-26 | 2.0 | etiqueta v1.6.13 | Apoyado |
1.6.12 | 2023-10-14 | 2.0 | etiqueta v1.6.12 | Apoyado |
1.6.11 | 2023-05-15 | 2.0 | etiqueta v1.6.11 | Apoyado |
1.6.10 | 2023-03-21 | 2.0 | etiqueta v1.6.10 | Apoyado |
1.6.9 | 2022-11-15 | 2.0 | etiqueta v1.6.9 | Apoyado |
1.6.8 | 2022-10-16 | 2.0 | etiqueta v1.6.8 | Apoyado |
1.6.7 | 2022-09-27 | 2.0 | etiqueta v1.6.7 | Apoyado |
1.6.6 | 2022-04-04 | 2.0 | etiqueta v1.6.6 | Apoyado |
1.6.5 | 2022-02-07 | 2.0 | etiqueta v1.6.5 | Apoyado |
1.6.4 | 2021-12-23 | 2.0 | etiqueta v1.6.4 | Apoyado |
1.6.3 | 2021-09-29 | 2.0 | etiqueta v1.6.3 | Apoyado |
1.6.2 | 2020-07-01 | 2.0 | etiqueta v1.6.2 | Apoyado |
1.6.1 | 2020-04-01 | 2.0 | etiqueta v1.6.1 | Apoyado |
1.6.0 | 2019-11-16 | 2.0 | etiqueta v1.6.0 | Apoyado |
1.5.24 | 2019-10-11 | 2.0 | etiqueta v1.5.24 | Apoyado |
1.5.23 | 2019-08-22 | 2.0 | etiqueta v1.5.23 | Apoyado |
1.5.22 | 2019-02-18 | 2.0 | etiqueta v1.5.22 | Apoyado |
1.5.21 | 2018-08-09 | 2.0 | etiqueta v1.5.21 | Apoyado |
1.5.20 | 2018-05-23 | 2.0 | etiqueta v1.5.20 | Apoyado |
2.0.2 | 2018-05-23 | 3.0 | etiqueta v2.0.2 | Apoyado |
2.0.1 | 2018-04-16 | 3.0 | etiqueta v2.0.1 | Apoyado |
1.5.19 | 2018-04-16 | 2.0 | etiqueta v1.5.19 | Apoyado |
2.0.0 | 2018-03-20 | 3.0 | etiqueta v2.0.0 | Apoyado |
2.0.0-rc4 | 2018-01-22 | 3.0 | etiqueta v2.0.0-rc4 | Apoyado |
2.0.0-rc3 | 2017-11-21 | 3.0 | etiqueta v2.0.0-rc3 | Apoyado |
2.0.0-rc2 | 2017-09-29 | 3.0 | etiqueta v2.0.0-rc2 | Apoyado |
2.0.0-rc1 | 2017-08-17 | 3.0 | etiqueta v2.0.0-rc1 | Apoyado |
1.5.18 | 2018-01-22 | 2.0 | etiqueta v1.5.18 | Apoyado |
1.5.17 | 2017-11-21 | 2.0 | etiqueta v1.5.17 | Apoyado |
1.5.16 | 2017-07-15 | 2.0 | etiqueta v1.5.16 | Apoyado |
1.3.12 | 2014-12-23 | 1.2 | etiqueta v1.3.12 | Apoyado |
1.2.4 | 2013-06-19 | 1.1 | etiqueta swagger-project_2.10.0-1.2.4 | En desuso |
1.0.0 | 2011-10-16 | 1.0 | etiqueta v1.0 | En desuso |
Si está interesado en el historial de cambios de swagger y el marco Swagger Core, consulte aquí.
Necesita lo siguiente instalado y disponible en su $PATH:
# first time building locally
mvn -N
Construcciones posteriores:
mvn install
Esto construirá los módulos.
Por supuesto, si no desea construir localmente, puede obtener artefactos de maven central:
https://repo1.maven.org/maven2/io/swagger/core/
Las muestras se han trasladado a un nuevo repositorio y contienen varias integraciones y configuraciones.
Informe cualquier problema o vulnerabilidad relacionada con la seguridad enviando un correo electrónico a [email protected], en lugar de utilizar el rastreador de problemas público.