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]]