Skip to content

Commit 9923ce4

Browse files
committed
[#129]; docs(openapi): v1.1.0으로 업데이트
1 parent 5c0de59 commit 9923ce4

2 files changed

Lines changed: 18 additions & 4 deletions

File tree

src/main/kotlin/com/yourssu/scouter/common/application/domain/authentication/AuthenticationController.kt

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,14 @@ class AuthenticationController(
8585
}
8686

8787
@SecurityRequirements // 로그인을 필요로 하지 않는 곳은 전역 인증을 사용하지않도록 초기화
88-
@Operation(summary = "토큰 재발급")
88+
@Operation(
89+
summary = "토큰 재발급",
90+
description = "Authorization 헤더는 무시되며, 바디의 refreshToken(순수 JWT)만 사용합니다.",
91+
responses = [
92+
ApiResponse(responseCode = "200", description = "OK"),
93+
ApiResponse(responseCode = "401", description = "Auth-001 (리프레시 토큰이 아닙니다. 등)")
94+
]
95+
)
8996
@PostMapping("/refresh-token")
9097
fun refreshToken(
9198
@RequestBody @Valid request: TokenRefreshRequest,

src/main/kotlin/com/yourssu/scouter/common/application/support/configuration/SwaggerConfiguration.kt

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,14 @@ class SwaggerConfiguration {
6666
private fun info() : Info {
6767
return Info()
6868
.title("Scouter API")
69-
.description("Scouter API")
70-
.version("v1.0.0")
69+
.description(
70+
"Changelog v1.1.0\n" +
71+
"- Token 응답 표준화: tokenType + accessToken + refreshToken\n" +
72+
"- 발급: 접두사 제거(순수 JWT), 수신: Bearer 유무 허용\n" +
73+
"- claims.tokenType 추가 및 타입 불일치 상세 오류메시지 (Auth-001)\n" +
74+
"- POST /refresh-token: Authorization 헤더 무시, body.refreshToken만 사용\n" +
75+
"- 메시지 상수화(InvalidTokenMessages)"
76+
)
77+
.version("v1.1.0")
7178
}
72-
}
79+
}

0 commit comments

Comments
 (0)