API 스펙: 가입 & 로그인 V3 medic-mydata

1. 중계시스템 인증 세션 생성

구현: MymdCertV3Controller → MymdCertSessionService

요청 (MymdCertRequestDto.Req)

인증

Authorization 헤더 유무 + socialLoginUuid로 CertType을 판별한다.

서버 처리

1. CertType 판별
2. 검증 (SIGN_UP: 이메일/비밀번호/약관 필수, SIGN_UP_WITH_SOCIAL: 소셜 로그인 결과 검증, MYMD_ONLY: 중계시스템 미가입 검증)
3. cert_uuid 생성
4. tb_mymd_cert_session INSERT (비밀번호 Pbkdf2SHA512 인코딩, MYMD_ONLY는 userSeq 저장)
5. 중계시스템 인증창 요청 (Feign)
6. 응답 반환

응답 (MymdCertRequestDto.Res)

{
  "certUuid": "발급된 UUID",
  "apiUrl": "중계시스템 인증 페이지 URL",
  "encryptData": "암호화된 인증 요청 데이터"
}

프론트 처리

sessionStorage.setItem('certUuid', certUuid);

const form = document.createElement('form');
form.method = 'POST';
form.action = apiUrl;

const input = document.createElement('input');
input.type = 'hidden';
input.name = 'encryptData';
input.value = encryptData;

form.appendChild(input);
document.body.appendChild(form);
form.submit();

에러 코드

2. 중계시스템 인증 결과 콜백

구현: MydataCertWebController (기존 V1 엔드포인트 재활용)

• 기존 V1 콜백 엔드포인트를 그대로 활용
• 중계시스템이 인증 완료 후 resultData 파라미터로 호출
• 서버가 resultData를 certResultData로 매핑하여 프론트 서버 URL로 302 리다이렉트

브라우저 흐름

프론트는 리다이렉트로 수신한 certResultData를 저장한다.

3. 회원가입

구현: AuthV3Controller → SignUpV3UseCase → DstatSignUpService + MymdSignUpService

요청 (SignUpV3Dto.Req)

서버 처리 흐름

DstatSignUpService 처리 순서

1. SNS CI 대조 (카카오/네이버만. 애플은 CI 미제공으로 생략)
2. CI 중복 확인 → 기가입이면 DUPLICATED_USER 또는 LINK_SOCIAL_ACCOUNT 반환 (200 OK)
3. 검증: 14세 미만 (SignUpAgePolicy), 이메일 중복 (SignUpEmailPolicy), 필수 약관 (SignUpTermAgreementPolicy)
4. 디스탯 회원 생성 (CI/이름/휴대폰 암호화, 비밀번호는 세션에서 인코딩된 값 사용)
5. 후처리: 약관 동의 저장, 알림 설정, 소셜 계정 연동, 알림톡 발송
6. OneTimeLogin UUID 발행

응답 — nextAction (SignUpV3Dto.Res)

응답 예시

SIGN_IN_ONE_TIME_UUID — 정상 가입 완료

{
  "nextAction": "SIGN_IN_ONE_TIME_UUID",
  "user": {
    "seq": 1,
    "email": "[email protected]",
    "socialAccounts": [
      { "seq": 1, "provider": "APPLE", "linkedDtm": "2026-03-18T12:00:00" }
    ]
  },
  "oneTimeLoginUuid": "xxx"
}

DUPLICATED_USER — CI 중복

{
  "nextAction": "DUPLICATED_USER",
  "user": {
    "seq": 2,
    "email": "[email protected]",
    "socialAccounts": [
      { "seq": 1, "provider": "APPLE", "linkedDtm": "2025-01-01T00:00:00" }
    ]
  }
}

LINK_SOCIAL_ACCOUNT — 애플 미연동

{
  "nextAction": "LINK_SOCIAL_ACCOUNT",
  "user": {
    "seq": 2,
    "email": "[email protected]",
    "socialAccounts": [
      { "seq": 1, "provider": "KAKAO", "linkedDtm": "2025-01-01T00:00:00" }
    ]
  },
  "socialLoginUuid": "yyy"
}

REGISTER_PATIENT_CONSENT — 중계시스템만 가입 완료

{
  "nextAction": "REGISTER_PATIENT_CONSENT"
}

DUPLICATED_USER, LINK_SOCIAL_ACCOUNT는 언제 발생하나?

카카오/네이버는 로그인 시점에 CI를 수신하여 가입 전에 회원 여부를 판별할 수 있다.
하지만 이메일 가입과 애플 로그인은 CI를 미리 알 수 없어, 중계시스템 인증 후에야 CI 중복이 확인된다.

에러 코드

4. 로그인

기존 POST /v2/auth/sign-in (이메일)과 POST /v2/oauth2/sign-in (소셜)을 통합하고, ONE_TIME_UUID 타입을 추가한다.

요청

SignInType

응답

{
  "accessToken": "JWT 액세스 토큰",
  "accessTokenExpirationDtm": "2026-03-18T12:00:00",
  "refreshToken": "JWT 리프레시 토큰",
  "refreshTokenExpirationDtm": "2026-04-18T12:00:00"
}

type별 서버 처리