REMARQUE : Si vous recherchez Swagger Core 1.5.X et OpenAPI 2.0, veuillez vous référer à la branche 1.5.
REMARQUE : Depuis la version 2.1.7, Swagger Core prend également en charge l'espace de noms Jakarta. Il existe un ensemble parallèle d'artefacts avec le suffixe -jakarta
, offrant la même fonctionnalité que les artefacts sans suffixe (c'est-à-dire : javax
). Veuillez consulter le Wiki pour plus de détails.
REMARQUE : depuis la version 2.2.0, Swagger Core prend en charge OpenAPI 3.1 ; voir cette page pour plus de détails
Swagger Core est une implémentation Java de la spécification OpenAPI. La version actuelle prend en charge JAX-RS2 (espaces de noms javax
et jakarta
).
Consultez le guide de démarrage avec Swagger Core pour commencer à ajouter Swagger à votre API.
Le wiki github contient de la documentation, des exemples, des contributions, etc. Commencez par là.
La spécification OpenAPI a subi plusieurs révisions depuis sa création initiale en 2010. Le projet Swagger Core présente les compatibilités suivantes avec la spécification OpenAPI :
Version principale de Swagger | Date de sortie | Compatibilité des spécifications OpenAPI | Remarques | Statut |
---|---|---|---|---|
2.2.26 ( stable actuel ) | 2024-11-18 | 3.x | balise v2.2.26 | Soutenu |
2.2.25 | 2024-10-02 | 3.x | balise v2.2.25 | Soutenu |
2.2.24 | 2024-09-23 | 3.x | balise v2.2.24 | Soutenu |
2.2.23 | 2024-08-28 | 3.x | balise v2.2.23 | Soutenu |
2.2.22 | 2024-05-15 | 3.x | balise v2.2.22 | Soutenu |
2.2.21 | 2024-03-20 | 3.x | balise v2.2.21 | Soutenu |
2.2.20 | 2023-12-19 | 3.x | balise v2.2.20 | Soutenu |
2.2.19 | 2023-11-10 | 3.x | balise v2.2.19 | Soutenu |
2.2.18 | 2023-10-25 | 3.x | balise v2.2.18 | Soutenu |
2.2.17 | 2023-10-12 | 3.x | balise v2.2.17 | Soutenu |
2.2.16 | 2023-09-18 | 3.x | balise v2.2.16 | Soutenu |
2.2.15 | 2023-07-08 | 3.x | balise v2.2.15 | Soutenu |
2.2.14 | 2023-06-26 | 3.x | balise v2.2.14 | Soutenu |
2.2.13 | 2023-06-24 | 3.x | balise v2.2.13 | Soutenu |
2.2.12 | 2023-06-13 | 3.x | balise v2.2.12 | Soutenu |
2.2.11 | 2023-06-01 | 3.x | balise v2.2.11 | Soutenu |
2.2.10 | 2023-05-15 | 3.x | balise v2.2.10 | Soutenu |
2.2.9 | 2023-03-20 | 3.x | balise v2.2.9 | Soutenu |
2.2.8 | 2023-01-06 | 3.x | balise v2.2.8 | Soutenu |
2.2.7 | 2022-11-15 | 3.0 | balise v2.2.7 | Soutenu |
2.2.6 | 2022-11-02 | 3.0 | balise v2.2.6 | Soutenu |
2.2.5 | 2022-11-02 | 3.0 | balise v2.2.5 | Soutenu |
2.2.4 | 2022-10-16 | 3.0 | balise v2.2.4 | Soutenu |
2.2.3 | 2022-09-27 | 3.0 | balise v2.2.3 | Soutenu |
2.2.2 | 2022-07-20 | 3.0 | balise v2.2.2 | Soutenu |
2.2.1 | 2022-06-15 | 3.0 | balise v2.2.1 | Soutenu |
2.2.0 | 2022-04-04 | 3.0 | balise v2.2.0 | Soutenu |
2.1.13 | 2022-02-07 | 3.0 | balise v2.1.13 | Soutenu |
2.1.12 | 2021-12-23 | 3.0 | balise v2.1.12 | Soutenu |
2.1.11 | 2021-09-29 | 3.0 | balise v2.1.11 | Soutenu |
2.1.10 | 2021-06-28 | 3.0 | balise v2.1.10 | Soutenu |
2.1.9 | 2021-04-20 | 3.0 | balise v2.1.9 | Soutenu |
2.1.8 | 2021-04-18 | 3.0 | balise v2.1.8 | Soutenu |
2.1.7 | 2021-02-18 | 3.0 | balise v2.1.7 | Soutenu |
2.1.6 | 2020-12-04 | 3.0 | balise v2.1.6 | Soutenu |
2.1.5 | 2020-10-01 | 3.0 | balise v2.1.5 | Soutenu |
2.1.4 | 2020-07-24 | 3.0 | balise v2.1.4 | Soutenu |
2.1.3 | 2020-06-27 | 3.0 | balise v2.1.3 | Soutenu |
2.1.2 | 2020-04-01 | 3.0 | balise v2.1.2 | Soutenu |
2.1.1 | 2020-01-02 | 3.0 | balise v2.1.1 | Soutenu |
2.1.0 | 2019-11-16 | 3.0 | balise v2.1.0 | Soutenu |
2.0.10 | 2019-10-11 | 3.0 | balise v2.0.10 | Soutenu |
2.0.9 | 2019-08-22 | 3.0 | balise v2.0.9 | Soutenu |
2.0.8 | 2019-04-24 | 3.0 | balise v2.0.8 | Soutenu |
2.0.7 | 2019-02-18 | 3.0 | balise v2.0.7 | Soutenu |
2.0.6 | 2018-11-27 | 3.0 | balise v2.0.6 | Soutenu |
2.0.5 | 2018-09-19 | 3.0 | balise v2.0.5 | Soutenu |
2.0.4 | 2018-09-05 | 3.0 | balise v2.0.4 | Soutenu |
2.0.3 | 2018-08-09 | 3.0 | balise v2.0.3 | Soutenu |
1.6.14 ( actuellement stable ) | 2024-03-19 | 2.0 | balise v1.6.14 | Soutenu |
1.6.13 | 2024-01-26 | 2.0 | balise v1.6.13 | Soutenu |
1.6.12 | 2023-10-14 | 2.0 | balise v1.6.12 | Soutenu |
1.6.11 | 2023-05-15 | 2.0 | balise v1.6.11 | Soutenu |
1.6.10 | 2023-03-21 | 2.0 | balise v1.6.10 | Soutenu |
1.6.9 | 2022-11-15 | 2.0 | balise v1.6.9 | Soutenu |
1.6.8 | 2022-10-16 | 2.0 | balise v1.6.8 | Soutenu |
1.6.7 | 2022-09-27 | 2.0 | balise v1.6.7 | Soutenu |
1.6.6 | 2022-04-04 | 2.0 | balise v1.6.6 | Soutenu |
1.6.5 | 2022-02-07 | 2.0 | balise v1.6.5 | Soutenu |
1.6.4 | 2021-12-23 | 2.0 | balise v1.6.4 | Soutenu |
1.6.3 | 2021-09-29 | 2.0 | balise v1.6.3 | Soutenu |
1.6.2 | 2020-07-01 | 2.0 | balise v1.6.2 | Soutenu |
1.6.1 | 2020-04-01 | 2.0 | balise v1.6.1 | Soutenu |
1.6.0 | 2019-11-16 | 2.0 | balise v1.6.0 | Soutenu |
1.5.24 | 2019-10-11 | 2.0 | balise v1.5.24 | Soutenu |
1.5.23 | 2019-08-22 | 2.0 | balise v1.5.23 | Soutenu |
1.5.22 | 2019-02-18 | 2.0 | balise v1.5.22 | Soutenu |
1.5.21 | 2018-08-09 | 2.0 | balise v1.5.21 | Soutenu |
1.5.20 | 2018-05-23 | 2.0 | balise v1.5.20 | Soutenu |
2.0.2 | 2018-05-23 | 3.0 | balise v2.0.2 | Soutenu |
2.0.1 | 2018-04-16 | 3.0 | balise v2.0.1 | Soutenu |
1.5.19 | 2018-04-16 | 2.0 | balise v1.5.19 | Soutenu |
2.0.0 | 2018-03-20 | 3.0 | balise v2.0.0 | Soutenu |
2.0.0-rc4 | 2018-01-22 | 3.0 | balise v2.0.0-rc4 | Soutenu |
2.0.0-rc3 | 2017-11-21 | 3.0 | balise v2.0.0-rc3 | Soutenu |
2.0.0-rc2 | 2017-09-29 | 3.0 | balise v2.0.0-rc2 | Soutenu |
2.0.0-rc1 | 2017-08-17 | 3.0 | balise v2.0.0-rc1 | Soutenu |
1.5.18 | 2018-01-22 | 2.0 | balise v1.5.18 | Soutenu |
1.5.17 | 2017-11-21 | 2.0 | balise v1.5.17 | Soutenu |
1.5.16 | 2017-07-15 | 2.0 | balise v1.5.16 | Soutenu |
1.3.12 | 2014-12-23 | 1.2 | balise v1.3.12 | Soutenu |
1.2.4 | 2013-06-19 | 1.1 | balise swagger-project_2.10.0-1.2.4 | Obsolète |
1.0.0 | 2011-10-16 | 1.0 | balise v1.0 | Obsolète |
Si vous êtes intéressé par l'historique des modifications de swagger et du framework Swagger Core, cliquez ici.
Vous avez besoin des éléments suivants installés et disponibles dans votre $PATH :
# first time building locally
mvn -N
Constructions suivantes :
mvn install
Cela construira les modules.
Bien sûr, si vous ne souhaitez pas construire localement, vous pouvez récupérer les artefacts de Maven Central :
https://repo1.maven.org/maven2/io/swagger/core/
Les exemples ont été déplacés vers un nouveau référentiel et contiennent diverses intégrations et configurations.
Veuillez divulguer tout problème ou vulnérabilité lié à la sécurité en envoyant un e-mail à [email protected], au lieu d'utiliser l'outil de suivi des problèmes public.