콘텐츠로 이동

sign_in_kakao (카카오 로그인)

카카오 Access Token으로 로그인합니다. 기존 계정이 없으면 추가 정보 입력을 안내합니다.

기본 정보

항목
URL https://asia-northeast3-construction24-test.cloudfunctions.net/sign_in_kakao
Method POST
인증 불필요

요청

Body

필드 타입 필수 설명 검증
access_token string O 카카오 Access Token -

요청 예시

{
  "access_token": "OxR2..."
}

응답

성공 - 기존 계정 (200)

{
  "message": "로그인 성공",
  "custom_token": "eyJhbGci...",
  "uid": "abc123..."
}

성공 - 신규 가입 필요 (200)

{
  "message": "추가 정보 입력 필요",
  "status": "need_signup",
  "signup_token": "a1b2c3d4...",
  "email": "hong@kakao.com",
  "name": "홍길동",
  "provider": "kakao"
}

실패

에러코드 message 원인
LOGIN_001 "계정이 잠겼습니다..." 계정 잠금
LOGIN_005 "소셜 인증 토큰 검증에 실패했습니다." 카카오 토큰 검증 실패
LOGIN_006 "이메일 정보를 가져올 수 없습니다..." 카카오에서 이메일 동의 안 함

참고

  • 카카오 개발자 콘솔에서 이메일을 "필수 동의"로 설정해야 합니다.
  • 관련 API: [[social_sign_up]], [[link_kakao]], [[unlink_kakao]]