swagger core
Swagger-core 2.2.26 released!
ПРИМЕЧАНИЕ. Если вы ищете Swagger Core 1.5.X и OpenAPI 2.0, обратитесь к ветке 1.5.
ПРИМЕЧАНИЕ. Начиная с версии 2.1.7, Swagger Core также поддерживает пространство имен Jakarta. Существует параллельный набор артефактов с суффиксом -jakarta , обеспечивающий ту же функциональность, что и артефакты без суффикса (т. е. javax ). Пожалуйста, посетите Wiki для более подробной информации.
ПРИМЕЧАНИЕ. Начиная с версии 2.2.0 Swagger Core поддерживает OpenAPI 3.1; подробности см. на этой странице
Swagger Core — это Java-реализация спецификации OpenAPI. Текущая версия поддерживает JAX-RS2 (пространства имен javax и jakarta ).
Ознакомьтесь с руководством по началу работы с Swagger Core, чтобы начать добавлять Swagger в свой API.
Вики-сайт github содержит документацию, примеры, материалы и т. д. Начните с этого.
Спецификация OpenAPI претерпела несколько изменений с момента первоначального создания в 2010 году. Проект Swagger Core имеет следующие совместимости со спецификацией OpenAPI:
| Версия ядра Swagger | Дата выпуска | Совместимость со спецификацией OpenAPI | Примечания | Статус |
|---|---|---|---|---|
| 2.2.26 ( текущая стабильная версия ) | 2024-11-18 | 3.х | тег v2.2.26 | Поддерживается |
| 2.2.25 | 2024-10-02 | 3.х | тег v2.2.25 | Поддерживается |
| 2.2.24 | 2024-09-23 | 3.х | тег v2.2.24 | Поддерживается |
| 2.2.23 | 2024-08-28 | 3.х | тег v2.2.23 | Поддерживается |
| 2.2.22 | 15 мая 2024 г. | 3.х | тег v2.2.22 | Поддерживается |
| 2.2.21 | 20 марта 2024 г. | 3.х | тег v2.2.21 | Поддерживается |
| 2.2.20 | 2023-12-19 | 3.х | тег v2.2.20 | Поддерживается |
| 2.2.19 | 2023-11-10 | 3.х | тег v2.2.19 | Поддерживается |
| 2.2.18 | 2023-10-25 | 3.х | тег v2.2.18 | Поддерживается |
| 2.2.17 | 2023-10-12 | 3.х | тег v2.2.17 | Поддерживается |
| 2.2.16 | 2023-09-18 | 3.х | тег v2.2.16 | Поддерживается |
| 2.2.15 | 08.07.2023 | 3.х | тег v2.2.15 | Поддерживается |
| 2.2.14 | 2023-06-26 | 3.х | тег v2.2.14 | Поддерживается |
| 2.2.13 | 2023-06-24 | 3.х | тег v2.2.13 | Поддерживается |
| 2.2.12 | 2023-06-13 | 3.х | тег v2.2.12 | Поддерживается |
| 2.2.11 | 01.06.2023 | 3.х | тег v2.2.11 | Поддерживается |
| 2.2.10 | 2023-05-15 | 3.х | тег v2.2.10 | Поддерживается |
| 2.2.9 | 20 марта 2023 г. | 3.х | тег v2.2.9 | Поддерживается |
| 2.2.8 | 06.01.2023 | 3.х | тег v2.2.8 | Поддерживается |
| 2.2.7 | 15 ноября 2022 г. | 3.0 | тег v2.2.7 | Поддерживается |
| 2.2.6 | 2022-11-02 | 3.0 | тег v2.2.6 | Поддерживается |
| 2.2.5 | 2022-11-02 | 3.0 | тег v2.2.5 | Поддерживается |
| 2.2.4 | 2022-10-16 | 3.0 | тег v2.2.4 | Поддерживается |
| 2.2.3 | 2022-09-27 | 3.0 | тег v2.2.3 | Поддерживается |
| 2.2.2 | 20 июля 2022 г. | 3.0 | тег v2.2.2 | Поддерживается |
| 2.2.1 | 15.06.2022 | 3.0 | тег v2.2.1 | Поддерживается |
| 2.2.0 | 2022-04-04 | 3.0 | тег v2.2.0 | Поддерживается |
| 2.1.13 | 07.02.2022 | 3.0 | тег v2.1.13 | Поддерживается |
| 2.1.12 | 2021-12-23 | 3.0 | тег v2.1.12 | Поддерживается |
| 2.1.11 | 2021-09-29 | 3.0 | тег v2.1.11 | Поддерживается |
| 2.1.10 | 2021-06-28 | 3.0 | тег v2.1.10 | Поддерживается |
| 2.1.9 | 20 апреля 2021 г. | 3.0 | тег v2.1.9 | Поддерживается |
| 2.1.8 | 2021-04-18 | 3.0 | тег v2.1.8 | Поддерживается |
| 2.1.7 | 18 февраля 2021 г. | 3.0 | тег v2.1.7 | Поддерживается |
| 2.1.6 | 2020-12-04 | 3.0 | тег v2.1.6 | Поддерживается |
| 2.1.5 | 01.10.2020 | 3.0 | тег v2.1.5 | Поддерживается |
| 2.1.4 | 2020-07-24 | 3.0 | тег v2.1.4 | Поддерживается |
| 2.1.3 | 2020-06-27 | 3.0 | тег v2.1.3 | Поддерживается |
| 2.1.2 | 2020-04-01 | 3.0 | тег v2.1.2 | Поддерживается |
| 2.1.1 | 2020-01-02 | 3.0 | тег v2.1.1 | Поддерживается |
| 2.1.0 | 2019-11-16 | 3.0 | тег v2.1.0 | Поддерживается |
| 2.0.10 | 2019-10-11 | 3.0 | тег v2.0.10 | Поддерживается |
| 2.0.9 | 2019-08-22 | 3.0 | тег v2.0.9 | Поддерживается |
| 2.0.8 | 2019-04-24 | 3.0 | тег v2.0.8 | Поддерживается |
| 2.0.7 | 2019-02-18 | 3.0 | тег v2.0.7 | Поддерживается |
| 2.0.6 | 2018-11-27 | 3.0 | тег v2.0.6 | Поддерживается |
| 2.0.5 | 2018-09-19 | 3.0 | тег v2.0.5 | Поддерживается |
| 2.0.4 | 2018-09-05 | 3.0 | тег v2.0.4 | Поддерживается |
| 2.0.3 | 09.08.2018 | 3.0 | тег v2.0.3 | Поддерживается |
| 1.6.14 ( текущая стабильная версия ) | 2024-03-19 | 2.0 | тег v1.6.14 | Поддерживается |
| 1.6.13 | 2024-01-26 | 2.0 | тег v1.6.13 | Поддерживается |
| 1.6.12 | 2023-10-14 | 2.0 | тег v1.6.12 | Поддерживается |
| 1.6.11 | 2023-05-15 | 2.0 | тег v1.6.11 | Поддерживается |
| 1.6.10 | 2023-03-21 | 2.0 | тег v1.6.10 | Поддерживается |
| 1.6.9 | 15 ноября 2022 г. | 2.0 | тег v1.6.9 | Поддерживается |
| 1.6.8 | 16.10.2022 | 2.0 | тег v1.6.8 | Поддерживается |
| 1.6.7 | 2022-09-27 | 2.0 | тег v1.6.7 | Поддерживается |
| 1.6.6 | 2022-04-04 | 2.0 | тег v1.6.6 | Поддерживается |
| 1.6.5 | 07.02.2022 | 2.0 | тег v1.6.5 | Поддерживается |
| 1.6.4 | 2021-12-23 | 2.0 | тег v1.6.4 | Поддерживается |
| 1.6.3 | 2021-09-29 | 2.0 | тег v1.6.3 | Поддерживается |
| 1.6.2 | 2020-07-01 | 2.0 | тег v1.6.2 | Поддерживается |
| 1.6.1 | 2020-04-01 | 2.0 | тег v1.6.1 | Поддерживается |
| 1.6.0 | 2019-11-16 | 2.0 | тег v1.6.0 | Поддерживается |
| 1.5.24 | 2019-10-11 | 2.0 | тег v1.5.24 | Поддерживается |
| 1.5.23 | 2019-08-22 | 2.0 | тег v1.5.23 | Поддерживается |
| 1.5.22 | 2019-02-18 | 2.0 | тег v1.5.22 | Поддерживается |
| 1.5.21 | 09.08.2018 | 2.0 | тег v1.5.21 | Поддерживается |
| 1.5.20 | 2018-05-23 | 2.0 | тег v1.5.20 | Поддерживается |
| 2.0.2 | 2018-05-23 | 3.0 | тег v2.0.2 | Поддерживается |
| 2.0.1 | 2018-04-16 | 3.0 | тег v2.0.1 | Поддерживается |
| 1.5.19 | 2018-04-16 | 2.0 | тег v1.5.19 | Поддерживается |
| 2.0.0 | 20.03.2018 | 3.0 | тег v2.0.0 | Поддерживается |
| 2.0.0-rc4 | 2018-01-22 | 3.0 | тег v2.0.0-rc4 | Поддерживается |
| 2.0.0-rc3 | 2017-11-21 | 3.0 | тег v2.0.0-rc3 | Поддерживается |
| 2.0.0-rc2 | 2017-09-29 | 3.0 | тег v2.0.0-rc2 | Поддерживается |
| 2.0.0-rc1 | 2017-08-17 | 3.0 | тег v2.0.0-rc1 | Поддерживается |
| 1.5.18 | 2018-01-22 | 2.0 | тег v1.5.18 | Поддерживается |
| 1.5.17 | 2017-11-21 | 2.0 | тег v1.5.17 | Поддерживается |
| 1.5.16 | 15 июля 2017 г. | 2.0 | тег v1.5.16 | Поддерживается |
| 1.3.12 | 2014-12-23 | 1.2 | тег v1.3.12 | Поддерживается |
| 1.2.4 | 19.06.2013 | 1.1 | тег swagger-project_2.10.0-1.2.4 | Устарело |
| 1.0.0 | 16 октября 2011 г. | 1.0 | тег v1.0 | Устарело |
Если вас интересует история изменений Swagger и платформы Swagger Core, см. здесь.
Вам необходимо, чтобы в вашем $PATH было установлено и доступно следующее:
# first time building locally
mvn -N
Последующие сборки:
mvn install
Это позволит построить модули.
Конечно, если вы не хотите выполнять сборку локально, вы можете получить артефакты из центра maven:
https://repo1.maven.org/maven2/io/swagger/core/
Образцы перемещены в новый репозиторий и содержат различные интеграции и конфигурации.
Пожалуйста, сообщайте о любых проблемах или уязвимостях, связанных с безопасностью, по электронной почте [email protected] вместо использования общедоступного средства отслеживания проблем.
