인증

카카오 로그인

Changed on

카카오 인가 코드를 교환해 로그인하고 토큰을 발급한다. 처음 온 카카오 계정이면 users 행을 만들고 isNewUser=true로 내린다.

profileCompleted=false면 가입 화면(PUT /v1/users/me/profile)을 끝내야 한다 — 그전까지 다른 API는 SIGNUP_NOT_COMPLETED(403)로 막힌다. 이때 함께 내려가는 nickname은 카카오 닉네임이라 입력칸 초깃값으로 쓸 수 있다. profileImageUrl은 가입 전에는 항상 null이다.

redirectUri는 인가 요청에 사용한 값과 같아야 한다. 이후 요청은 Authorization: Bearer {accessToken}으로 보내고, 만료(AUTH_TOKEN_EXPIRED)되면 재발급 API로 갱신한다.

post/v1/auth/login/kakao

Request

  • Base URL: http://localhost:8080/api
  • URL: http://localhost:8080/api/v1/auth/login/kakao
  • Auth: none declared

Request body

codestring required

카카오 인가 코드. 1회용이라 재사용하면 AUTH_KAKAO_CODE_INVALID다

redirectUristring required

인가 요청에 사용한 리다이렉트 URI

Example request

{
  "redirectUri": "http://localhost:3000/auth/kakao/callback"
}

Response

OK

Changes