Auth

구글 인증 진입

구글 idToken 을 검증하고 계정 상태에 따라 status 로 분기한다. 이미 구글이 연결된 계정이 탈퇴 후 30일 이내(휴면)라면 자동으로 복구한 뒤 LOGIN 으로 응답한다. 아직 구글이 연결되지 않은 탈퇴 계정(LINK_REQUIRED 대상)이거나 유예기간이 지난 탈퇴 계정이면 409 예외(AUTH-014 또는 AUTH-013)를 반환한다.

LOGIN: 토큰 발급. LINK_REQUIRED: linkRequired 와 email 을 내려주며, 사용자 확인 후 POST /auth/google/link 호출. SIGNUP_REQUIRED: signupRequired 와 일회성 signupToken, 프리필 값을 내려준다.

post/api/v1/auth/google

Request

Base URL: https://api.chaeso-zip.com
URL: https://api.chaeso-zip.com/api/v1/auth/google
Auth: none declared

Request body

idTokenstring required

Google Identity Services 로 받은 idToken

Example request

{
  "idToken": "eyJhbGciOiJSUzI1NiJ9..."
}

Response

로그인 성공(탈퇴 후 30일 이내 자동 복구) / 연결 확인 필요 / 가입 필요

successboolean required

요청 성공 여부

codestring nullable required

성공 안내 코드. 안내할 것이 없으면 null

Example response

{
  "success": true,
  "data": {
    "accessTokenExpiresIn": 1800,
    "refreshTokenExpiresIn": 1209600,
    "linkRequired": true,
    "signupRequired": true,
    "prefill": {
      "email": "user@chaeso.zip",
      "suggestedNickname": "홍길동"
    }
  },
  "error": {
    "code": "C-001",
    "message": "입력값이 올바르지 않습니다.",
    "fieldErrors": [
      {
        "field": "name",
        "reason": "이름은 필수입니다."
      }
    ]
  },
  "code": "GOOGLE_ACCOUNT_LINKED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.