콘텐츠로 이동

sign_in_google (Google 로그인)

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

기본 정보

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

요청

Body

필드 타입 필수 설명 검증
id_token string O Google ID Token -

요청 예시

{
  "id_token": "eyJhbGciOiJSUzI1NiIs..."
}

응답

성공 - 기존 계정 (200)

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

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

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

실패

에러코드 message 원인
LOGIN_001 "계정이 잠겼습니다..." 계정 잠금
LOGIN_005 "소셜 인증 토큰 검증에 실패했습니다." Google 토큰 검증 실패
LOGIN_006 "이메일 정보를 가져올 수 없습니다..." 이메일 미제공

참고

  • status: "need_signup" 응답 시 [[social_sign_up]]으로 추가 정보를 제출해야 합니다.
  • signup_token은 30분간 유효합니다.
  • 같은 이메일의 기존 계정이 있으면 자동으로 Google 연동 후 로그인됩니다. (별도 연동 절차 불필요)
  • login_providers에는 소셜 연동 정보만 저장됩니다. (이메일 로그인은 전원 가능하므로 별도 표기 없음)
  • 예: [] = 이메일만, ["google"] = 이메일 + Google
  • 관련 API: [[social_sign_up]], [[link_google]], [[unlink_google]]