Skip to content

[web-32] 인증 API prefix /api/v1/auth 적용 및 Swagger 문서 개선#20

Merged
Chunwol merged 1 commit into
developfrom
refactor/web-32
May 21, 2026
Merged

[web-32] 인증 API prefix /api/v1/auth 적용 및 Swagger 문서 개선#20
Chunwol merged 1 commit into
developfrom
refactor/web-32

Conversation

@Chunwol
Copy link
Copy Markdown
Member

@Chunwol Chunwol commented May 21, 2026

작업 내용p

Auth API의 Swagger 문서를 개선하고 공통 API prefix /api/v1/를 적용합니다.

변경 사항

  • AuthController 요청 경로 /auth/**/api/v1/auth/** 변경
  • @SecurityRequirements 적용으로 Swagger에서 auth 엔드포인트 자물쇠 제거
  • 기존 verbose @ApiResponses 제거 → @ApiErrorExceptions 커스텀 어노테이션으로 교체
  • SecurityConfig PUBLIC_URLS 및 OpenApiConfig path 패턴 /api/v1/auth/** 통일
  • OpenApiConfigNotFound(404) 공통 응답 컴포넌트 추가

테스트

  • POST /api/v1/auth/login Swagger에서 자물쇠 없이 노출 확인
  • POST /api/v1/auth/refresh, POST /api/v1/auth/logout 동일 확인

- AuthController: /auth -> /api/v1/auth prefix 변경
- AuthController: @SecurityRequirements 추가 (Swagger 로그인 자물쇠 제거)
- AuthController: @ApiErrorExceptions 적용, 기존 verbose @ApiResponses 제거
- SecurityConfig: PUBLIC_URLS /auth/** -> /api/v1/auth/** 변경
- OpenApiConfig: authApi /api/v1/auth/**, adminApi /api/v1/** 경로 통일
- ApiErrorExceptions: ErrorCode 기반 에러 응답 자동 등록 어노테이션 추가
- ApiErrorExceptionCustomizer: OperationCustomizer 구현체 추가
@Chunwol Chunwol requested a review from chldPDms May 21, 2026 02:41
@Chunwol Chunwol self-assigned this May 21, 2026
@Chunwol Chunwol merged commit 35de30f into develop May 21, 2026
@Chunwol Chunwol deleted the refactor/web-32 branch May 21, 2026 03:27
Chunwol added a commit that referenced this pull request May 24, 2026
[web-32] 인증 API prefix /api/v1/auth 적용 및 Swagger 문서 개선
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant