generated from pricelees/issue-pr-template
53 lines
1.9 KiB
Kotlin
53 lines
1.9 KiB
Kotlin
package roomescape.auth.docs
|
|
|
|
import io.swagger.v3.oas.annotations.Operation
|
|
import io.swagger.v3.oas.annotations.responses.ApiResponse
|
|
import io.swagger.v3.oas.annotations.responses.ApiResponses
|
|
import io.swagger.v3.oas.annotations.tags.Tag
|
|
import jakarta.servlet.http.HttpServletRequest
|
|
import jakarta.servlet.http.HttpServletResponse
|
|
import jakarta.validation.Valid
|
|
import org.springframework.http.ResponseEntity
|
|
import org.springframework.web.bind.annotation.RequestBody
|
|
import roomescape.auth.web.LoginRequest
|
|
import roomescape.auth.web.LoginSuccessResponse
|
|
import roomescape.auth.web.support.CurrentUser
|
|
import roomescape.auth.web.support.Public
|
|
import roomescape.common.dto.CurrentUserContext
|
|
import roomescape.common.dto.response.CommonApiResponse
|
|
|
|
@Tag(name = "1. 인증 / 인가 API", description = "로그인, 로그아웃 및 로그인 상태를 확인합니다")
|
|
interface AuthAPI {
|
|
|
|
@Public
|
|
@Operation(summary = "로그인")
|
|
@ApiResponses(
|
|
ApiResponse(responseCode = "200", description = "로그인 성공시 토큰을 반환합니다."),
|
|
)
|
|
fun login(
|
|
@Valid @RequestBody loginRequest: LoginRequest,
|
|
servletRequest: HttpServletRequest
|
|
): ResponseEntity<CommonApiResponse<LoginSuccessResponse>>
|
|
|
|
@Operation(summary = "로그인 상태 확인")
|
|
@ApiResponses(
|
|
ApiResponse(
|
|
responseCode = "200",
|
|
description = "입력된 ID / 결과(Boolean)을 반환합니다.",
|
|
useReturnTypeSchema = true
|
|
),
|
|
)
|
|
fun checkLogin(
|
|
@CurrentUser user: CurrentUserContext
|
|
): ResponseEntity<CommonApiResponse<CurrentUserContext>>
|
|
|
|
@Operation(summary = "로그아웃", tags = ["로그인이 필요한 API"])
|
|
@ApiResponses(
|
|
ApiResponse(responseCode = "200"),
|
|
)
|
|
fun logout(
|
|
@CurrentUser user: CurrentUserContext,
|
|
servletResponse: HttpServletResponse
|
|
): ResponseEntity<CommonApiResponse<Unit>>
|
|
}
|