sign_in_apple (Apple 로그인)

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

기본 정보

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

요청

Body

필드	타입	필수	설명	검증
id_token	string	O	Apple ID Token	-
name	string	X	사용자 이름 (Apple이 최초 1회만 전달)	-

요청 예시

{
  "id_token": "eyJhbGciOiJSUzI1NiIs...",
  "name": "홍길동"
}

응답

성공 - 기존 계정 (200)

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

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

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

실패

에러코드	message	원인
LOGIN_001	"계정이 잠겼습니다..."	계정 잠금
LOGIN_005	"소셜 인증 토큰 검증에 실패했습니다."	Apple 토큰 검증 실패
LOGIN_006	"이메일 정보를 가져올 수 없습니다. 실제 이메일을 제공해주세요."	Apple "이메일 숨기기" 사용 또는 이메일 미제공

참고

Apple "이메일 숨기기" 사용 불가: @privaterelay.apple.com 이메일은 거부됩니다. 실제 이메일로 다시 시도해주세요.
Apple은 사용자 이름을 최초 로그인 시 1회만 전달합니다. name 필드를 반드시 포함시켜주세요.
같은 이메일의 기존 계정이 있으면 자동으로 Apple 연동 후 로그인됩니다.
login_providers에는 소셜 연동 정보만 저장됩니다. (이메일 로그인은 전원 가능하므로 별도 표기 없음)
관련 API: [[social_sign_up]], [[link_apple]], [[unlink_apple]]