api 그룹 설정 : @Tag api Schema 설정 : @Schema api 상세 정보 설정 : @Operation api response 설정 : @ApiResponse api parameter 설정 : @Parameter 이전시간에 OpenAPI info 정보만 설정했었습니다. Schemas 에 대한 설명과 들어갈 값에대한 정보도 없고, api method에 대한 설명도 없어서 api 이용에 불편함이 있습니다. 이번시간에는 Swagger v3 Annotation을 이용하여 API 문서의 설명을 구체적으로 작성하고, Java Bean Validation 을 이용하여 api 사용시 유효성 체크를 합니다. 1. api 그룹 설정 : @Tag Target : ANNOTATION_TYPE, METHOD, ..

OpenAPI 3.0 OAS 란? Swagger 란? springdoc-openapi 설정 의존성 라이브러리 추가 프로퍼티 설정 (operations-sorter, display-query-params-without-oauth2) Swagger Info 설정 Swagger-ui 실행 /swagger-ui/index.html Swagger-ui 실행 및 csrf token 문제점 2. 설정 2.1. 의존성 라이브러리 추가 pom.xml에 springdoc-openapi 을 추가합니다. org.springdoc springdoc-openapi-ui 1.6.6 2.2. 프로퍼티 설정 springdoc: version: '@project.version@' api-docs: path: /api-..