HINWEIS: Wenn Sie nach Swagger Core 1.5.X und OpenAPI 2.0 suchen, lesen Sie bitte den Zweig 1.5.
HINWEIS: Seit Version 2.1.7 unterstützt Swagger Core auch den Jakarta-Namespace. Es gibt einen parallelen Satz von Artefakten mit dem Suffix -jakarta
, die die gleiche Funktionalität wie die Artefakte ohne Suffix (z. B. javax
) bieten. Weitere Informationen finden Sie im Wiki.
HINWEIS: Seit Version 2.2.0 unterstützt Swagger Core OpenAPI 3.1; Einzelheiten finden Sie auf dieser Seite
Swagger Core ist eine Java-Implementierung der OpenAPI-Spezifikation. Die aktuelle Version unterstützt JAX-RS2 ( javax
und jakarta
Namespaces).
Sehen Sie sich die Anleitung zum Einstieg in Swagger Core an, um mit dem Hinzufügen von Swagger zu Ihrer API zu beginnen.
Das Github-Wiki enthält Dokumentation, Beispiele, Beiträge usw. Beginnen Sie dort.
Die OpenAPI-Spezifikation wurde seit ihrer ersten Erstellung im Jahr 2010 mehreren Überarbeitungen unterzogen. Das Swagger Core-Projekt weist die folgenden Kompatibilitäten mit der OpenAPI-Spezifikation auf:
Swagger-Kernversion | Veröffentlichungsdatum | Kompatibilität mit OpenAPI-Spezifikationen | Notizen | Status |
---|---|---|---|---|
2.2.26 ( aktuell stabil ) | 18.11.2024 | 3.x | Tag v2.2.26 | Unterstützt |
2.2.25 | 02.10.2024 | 3.x | Tag v2.2.25 | Unterstützt |
2.2.24 | 23.09.2024 | 3.x | Tag v2.2.24 | Unterstützt |
2.2.23 | 28.08.2024 | 3.x | Tag v2.2.23 | Unterstützt |
2.2.22 | 15.05.2024 | 3.x | Tag v2.2.22 | Unterstützt |
2.2.21 | 20.03.2024 | 3.x | Tag v2.2.21 | Unterstützt |
2.2.20 | 19.12.2023 | 3.x | Tag v2.2.20 | Unterstützt |
2.2.19 | 10.11.2023 | 3.x | Tag v2.2.19 | Unterstützt |
2.2.18 | 25.10.2023 | 3.x | Tag v2.2.18 | Unterstützt |
2.2.17 | 12.10.2023 | 3.x | Tag v2.2.17 | Unterstützt |
2.2.16 | 18.09.2023 | 3.x | Tag v2.2.16 | Unterstützt |
2.2.15 | 08.07.2023 | 3.x | Tag v2.2.15 | Unterstützt |
2.2.14 | 26.06.2023 | 3.x | Tag v2.2.14 | Unterstützt |
2.2.13 | 24.06.2023 | 3.x | Tag v2.2.13 | Unterstützt |
2.2.12 | 13.06.2023 | 3.x | Tag v2.2.12 | Unterstützt |
2.2.11 | 01.06.2023 | 3.x | Tag v2.2.11 | Unterstützt |
2.2.10 | 15.05.2023 | 3.x | Tag v2.2.10 | Unterstützt |
2.2.9 | 20.03.2023 | 3.x | Tag v2.2.9 | Unterstützt |
2.2.8 | 06.01.2023 | 3.x | Tag v2.2.8 | Unterstützt |
2.2.7 | 15.11.2022 | 3,0 | Tag v2.2.7 | Unterstützt |
2.2.6 | 02.11.2022 | 3,0 | Tag v2.2.6 | Unterstützt |
2.2.5 | 02.11.2022 | 3,0 | Tag v2.2.5 | Unterstützt |
2.2.4 | 16.10.2022 | 3,0 | Tag v2.2.4 | Unterstützt |
2.2.3 | 27.09.2022 | 3,0 | Tag v2.2.3 | Unterstützt |
2.2.2 | 20.07.2022 | 3,0 | Tag v2.2.2 | Unterstützt |
2.2.1 | 15.06.2022 | 3,0 | Tag v2.2.1 | Unterstützt |
2.2.0 | 04.04.2022 | 3,0 | Tag v2.2.0 | Unterstützt |
2.1.13 | 07.02.2022 | 3,0 | Tag v2.1.13 | Unterstützt |
2.1.12 | 23.12.2021 | 3,0 | Tag v2.1.12 | Unterstützt |
2.1.11 | 29.09.2021 | 3,0 | Tag v2.1.11 | Unterstützt |
2.1.10 | 28.06.2021 | 3,0 | Tag v2.1.10 | Unterstützt |
2.1.9 | 20.04.2021 | 3,0 | Tag v2.1.9 | Unterstützt |
2.1.8 | 18.04.2021 | 3,0 | Tag v2.1.8 | Unterstützt |
2.1.7 | 18.02.2021 | 3,0 | Tag v2.1.7 | Unterstützt |
2.1.6 | 04.12.2020 | 3,0 | Tag v2.1.6 | Unterstützt |
2.1.5 | 01.10.2020 | 3,0 | Tag v2.1.5 | Unterstützt |
2.1.4 | 24.07.2020 | 3,0 | Tag v2.1.4 | Unterstützt |
2.1.3 | 27.06.2020 | 3,0 | Tag v2.1.3 | Unterstützt |
2.1.2 | 01.04.2020 | 3,0 | Tag v2.1.2 | Unterstützt |
2.1.1 | 02.01.2020 | 3,0 | Tag v2.1.1 | Unterstützt |
2.1.0 | 16.11.2019 | 3,0 | Tag v2.1.0 | Unterstützt |
2.0.10 | 11.10.2019 | 3,0 | Tag v2.0.10 | Unterstützt |
2.0.9 | 22.08.2019 | 3,0 | Tag v2.0.9 | Unterstützt |
2.0.8 | 24.04.2019 | 3,0 | Tag v2.0.8 | Unterstützt |
2.0.7 | 18.02.2019 | 3,0 | Tag v2.0.7 | Unterstützt |
2.0.6 | 27.11.2018 | 3,0 | Tag v2.0.6 | Unterstützt |
2.0.5 | 19.09.2018 | 3,0 | Tag v2.0.5 | Unterstützt |
2.0.4 | 05.09.2018 | 3,0 | Tag v2.0.4 | Unterstützt |
2.0.3 | 09.08.2018 | 3,0 | Tag v2.0.3 | Unterstützt |
1.6.14 ( aktuell stabil ) | 19.03.2024 | 2,0 | Tag v1.6.14 | Unterstützt |
1.6.13 | 26.01.2024 | 2,0 | Tag v1.6.13 | Unterstützt |
1.6.12 | 14.10.2023 | 2,0 | Tag v1.6.12 | Unterstützt |
1.6.11 | 15.05.2023 | 2,0 | Tag v1.6.11 | Unterstützt |
1.6.10 | 21.03.2023 | 2,0 | Tag v1.6.10 | Unterstützt |
1.6.9 | 15.11.2022 | 2,0 | Tag v1.6.9 | Unterstützt |
1.6.8 | 16.10.2022 | 2,0 | Tag v1.6.8 | Unterstützt |
1.6.7 | 27.09.2022 | 2,0 | Tag v1.6.7 | Unterstützt |
1.6.6 | 04.04.2022 | 2,0 | Tag v1.6.6 | Unterstützt |
1.6.5 | 07.02.2022 | 2,0 | Tag v1.6.5 | Unterstützt |
1.6.4 | 23.12.2021 | 2,0 | Tag v1.6.4 | Unterstützt |
1.6.3 | 29.09.2021 | 2,0 | Tag v1.6.3 | Unterstützt |
1.6.2 | 01.07.2020 | 2,0 | Tag v1.6.2 | Unterstützt |
1.6.1 | 01.04.2020 | 2,0 | Tag v1.6.1 | Unterstützt |
1.6.0 | 16.11.2019 | 2,0 | Tag v1.6.0 | Unterstützt |
1.5.24 | 11.10.2019 | 2,0 | Tag v1.5.24 | Unterstützt |
1.5.23 | 22.08.2019 | 2,0 | Tag v1.5.23 | Unterstützt |
1.5.22 | 18.02.2019 | 2,0 | Tag v1.5.22 | Unterstützt |
1.5.21 | 09.08.2018 | 2,0 | Tag v1.5.21 | Unterstützt |
1.5.20 | 23.05.2018 | 2,0 | Tag v1.5.20 | Unterstützt |
2.0.2 | 23.05.2018 | 3,0 | Tag v2.0.2 | Unterstützt |
2.0.1 | 16.04.2018 | 3,0 | Tag v2.0.1 | Unterstützt |
1.5.19 | 16.04.2018 | 2,0 | Tag v1.5.19 | Unterstützt |
2.0.0 | 20.03.2018 | 3,0 | Tag v2.0.0 | Unterstützt |
2.0.0-rc4 | 22.01.2018 | 3,0 | Tag v2.0.0-rc4 | Unterstützt |
2.0.0-rc3 | 21.11.2017 | 3,0 | Tag v2.0.0-rc3 | Unterstützt |
2.0.0-rc2 | 29.09.2017 | 3,0 | Tag v2.0.0-rc2 | Unterstützt |
2.0.0-rc1 | 17.08.2017 | 3,0 | Tag v2.0.0-rc1 | Unterstützt |
1.5.18 | 22.01.2018 | 2,0 | Tag v1.5.18 | Unterstützt |
1.5.17 | 21.11.2017 | 2,0 | Tag v1.5.17 | Unterstützt |
1.5.16 | 15.07.2017 | 2,0 | Tag v1.5.16 | Unterstützt |
1.3.12 | 23.12.2014 | 1.2 | Tag v1.3.12 | Unterstützt |
1.2.4 | 19.06.2013 | 1.1 | Tag swagger-project_2.10.0-1.2.4 | Veraltet |
1.0.0 | 16.10.2011 | 1,0 | Tag v1.0 | Veraltet |
Wenn Sie sich für den Änderungsverlauf von Swagger und dem Swagger Core-Framework interessieren, lesen Sie hier.
Folgendes muss installiert und in Ihrem $PATH verfügbar sein:
# first time building locally
mvn -N
Nachfolgende Builds:
mvn install
Dadurch werden die Module erstellt.
Wenn Sie nicht lokal bauen möchten, können Sie natürlich Artefakte von Maven Central abrufen:
https://repo1.maven.org/maven2/io/swagger/core/
Die Beispiele wurden in ein neues Repository verschoben und enthalten verschiedene Integrationen und Konfigurationen.
Bitte melden Sie alle sicherheitsrelevanten Probleme oder Schwachstellen per E-Mail an [email protected], anstatt den öffentlichen Issue-Tracker zu verwenden.