참고: Swagger Core 1.5.X 및 OpenAPI 2.0을 찾고 있다면 1.5 분기를 참조하세요.
참고: 버전 2.1.7부터 Swagger Core는 Jakarta 네임스페이스도 지원합니다. 접미사가 붙지 않은(예: javax
) 아티팩트와 동일한 기능을 제공하는 -jakarta
접미사가 있는 병렬 아티팩트 세트가 있습니다. 자세한 내용은 위키를 참조하세요.
참고: 버전 2.2.0부터 Swagger Core는 OpenAPI 3.1을 지원합니다. 자세한 내용은 이 페이지를 참조하세요.
Swagger Core는 OpenAPI 사양을 Java로 구현한 것입니다. 현재 버전은 JAX-RS2 ( javax
및 jakarta
네임스페이스)를 지원합니다.
API에 Swagger 추가를 시작하려면 Swagger Core 시작하기 가이드를 참조하세요.
github 위키에는 문서, 샘플, 기여 등이 포함되어 있습니다. 거기서 시작하세요.
OpenAPI 사양은 2010년 처음 생성된 이후 여러 번의 개정을 거쳤습니다. Swagger Core 프로젝트는 OpenAPI 사양과 다음과 같은 호환성을 갖습니다.
Swagger 코어 버전 | 출시일 | OpenAPI 사양 호환성 | 메모 | 상태 |
---|---|---|---|---|
2.2.26 ( 현재 안정 ) | 2024-11-18 | 3.x | 태그 v2.2.26 | 지원됨 |
2.2.25 | 2024-10-02 | 3.x | 태그 v2.2.25 | 지원됨 |
2.2.24 | 2024-09-23 | 3.x | 태그 v2.2.24 | 지원됨 |
2.2.23 | 2024-08-28 | 3.x | 태그 v2.2.23 | 지원됨 |
2.2.22 | 2024-05-15 | 3.x | 태그 v2.2.22 | 지원됨 |
2.2.21 | 2024-03-20 | 3.x | 태그 v2.2.21 | 지원됨 |
2.2.20 | 2023-12-19 | 3.x | 태그 v2.2.20 | 지원됨 |
2.2.19 | 2023-11-10 | 3.x | 태그 v2.2.19 | 지원됨 |
2.2.18 | 2023-10-25 | 3.x | 태그 v2.2.18 | 지원됨 |
2.2.17 | 2023-10-12 | 3.x | 태그 v2.2.17 | 지원됨 |
2.2.16 | 2023-09-18 | 3.x | 태그 v2.2.16 | 지원됨 |
2.2.15 | 2023-07-08 | 3.x | 태그 v2.2.15 | 지원됨 |
2.2.14 | 2023-06-26 | 3.x | 태그 v2.2.14 | 지원됨 |
2.2.13 | 2023-06-24 | 3.x | 태그 v2.2.13 | 지원됨 |
2.2.12 | 2023-06-13 | 3.x | 태그 v2.2.12 | 지원됨 |
2.2.11 | 2023-06-01 | 3.x | 태그 v2.2.11 | 지원됨 |
2.2.10 | 2023-05-15 | 3.x | 태그 v2.2.10 | 지원됨 |
2.2.9 | 2023-03-20 | 3.x | 태그 v2.2.9 | 지원됨 |
2.2.8 | 2023-01-06 | 3.x | 태그 v2.2.8 | 지원됨 |
2.2.7 | 2022-11-15 | 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 | 2022-07-20 | 3.0 | 태그 v2.2.2 | 지원됨 |
2.2.1 | 2022-06-15 | 3.0 | 태그 v2.2.1 | 지원됨 |
2.2.0 | 2022-04-04 | 3.0 | 태그 v2.2.0 | 지원됨 |
2.1.13 | 2022-02-07 | 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 | 2021-04-20 | 3.0 | 태그 v2.1.9 | 지원됨 |
2.1.8 | 2021-04-18 | 3.0 | 태그 v2.1.8 | 지원됨 |
2.1.7 | 2021-02-18 | 3.0 | 태그 v2.1.7 | 지원됨 |
2.1.6 | 2020-12-04 | 3.0 | 태그 v2.1.6 | 지원됨 |
2.1.5 | 2020-10-01 | 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 | 2018-08-09 | 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 | 2022-11-15 | 2.0 | 태그 v1.6.9 | 지원됨 |
1.6.8 | 2022-10-16 | 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 | 2022-02-07 | 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 | 2018-08-09 | 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 | 2018-03-20 | 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 | 2017-07-15 | 2.0 | 태그 v1.5.16 | 지원됨 |
1.3.12 | 2014-12-23 | 1.2 | 태그 v1.3.12 | 지원됨 |
1.2.4 | 2013-06-19 | 1.1 | 태그 swagger-project_2.10.0-1.2.4 | 더 이상 사용되지 않음 |
1.0.0 | 2011-10-16 | 1.0 | 태그 v1.0 | 더 이상 사용되지 않음 |
Swagger 및 Swagger Core 프레임워크의 변경 내역에 관심이 있는 경우 여기를 참조하세요.
$PATH에 다음이 설치되어 있어야 하며 사용 가능해야 합니다.
# first time building locally
mvn -N
후속 빌드:
mvn install
그러면 모듈이 빌드됩니다.
물론 로컬로 빌드하고 싶지 않다면 Maven Central에서 아티팩트를 가져올 수 있습니다.
https://repo1.maven.org/maven2/io/swagger/core/
샘플이 새 저장소로 이동되었으며 다양한 통합 및 구성이 포함되어 있습니다.
공개 문제 추적기를 사용하는 대신 [email protected]로 이메일을 보내 보안 관련 문제나 취약점을 공개해 주십시오.