개요
User 서비스의 인증 도메인은 다양한 인증 방식을 제공합니다. SMS 인증, 이메일 인증, OTP(일회용 비밀번호), 익명 로그인, 서드파티 토큰 관리 등을 지원합니다.Queries
refreshToken
리프레시 토큰을 사용하여 새로운 액세스 토큰을 발급받습니다.GraphQL Signature
파라미터
기존 리프레시 토큰
응답
새로 발급된 액세스 토큰
새로 발급된 리프레시 토큰
예제
thirdParties
등록된 모든 서드파티 사용자 목록을 조회합니다.GraphQL Signature
응답
서드파티 사용자 ID
서드파티 이름
권한 레벨
신뢰할 수 있는 호스트 목록
Mutations
requestAnonymousSignIn
익명 로그인 요청을 생성하고 인증 토큰을 발급합니다.GraphQL Signature
파라미터
익명 로그인 타입 (선택사항)
응답
인증 ID
익명 로그인 토큰
예제
waitAnonymousSignIn
익명 로그인 승인을 대기합니다.GraphQL Signature
파라미터
익명 로그인 토큰
인증 ID
응답
로그인 결과 문자열
anonymousSignIn
익명 로그인을 승인합니다.GraphQL Signature
파라미터
익명 로그인 토큰
응답
성공 여부
에러 메시지 (실패 시)
requestSMSAuth
휴대폰 번호로 SMS 인증번호를 발송합니다.GraphQL Signature
파라미터
인증번호를 받을 휴대폰 번호
응답
SMS 발송 성공 여부
에러 메시지 (실패 시)
예제
confirmSMSAuth
SMS로 받은 인증번호를 검증하고 인증 해시를 발급합니다.GraphQL Signature
파라미터
인증번호를 받은 휴대폰 번호
SMS로 받은 인증번호
응답
인증 해시 (회원가입 또는 비밀번호 변경 시 사용)
예제
verifyEmail
이메일 인증을 확인합니다.GraphQL Signature
파라미터
인증할 이메일 주소
이메일로 받은 인증 해시
응답
이메일 인증 성공 여부
에러 메시지 (실패 시)
requestEmailVerification
로그인한 사용자의 이메일로 인증 메일을 발송합니다.GraphQL Signature
응답
이메일 발송 성공 여부
이 API는 인증이 필요하며, 로그인한 사용자의 이메일로 자동 발송됩니다.
revokeToken
현재 사용 중인 토큰을 폐기하고 새 토큰을 발급합니다.GraphQL Signature
응답
새로 발급된 액세스 토큰
새로 발급된 리프레시 토큰
setOtpKey
OTP(일회용 비밀번호) 키를 생성합니다.GraphQL Signature
응답
OTP 시크릿 키
QR 코드 이미지 (Base64 또는 URL)
예제
QR 코드를 Google Authenticator 또는 다른 OTP 앱으로 스캔하여 등록하세요.
lockOtpKey
OTP 키를 검증하고 활성화합니다.GraphQL Signature
파라미터
OTP 앱에서 생성된 6자리 코드
응답
OTP 활성화 성공 여부
예제
getThirdPartyToken
서드파티 시스템용 토큰을 발급받습니다.GraphQL Signature
파라미터
서드파티 시스템 이름
응답
서드파티 토큰
registerThirdParty
새로운 서드파티 사용자를 등록합니다.GraphQL Signature
파라미터
서드파티 이름
권한 목록
신뢰할 수 있는 호스트 (선택사항)
응답
생성된 서드파티 사용자 ID
서드파티 이름
권한 레벨
신뢰할 수 있는 호스트
updateThirdParty
기존 서드파티 사용자 정보를 수정합니다.GraphQL Signature
파라미터
수정할 서드파티 사용자 ID
새로운 이름 (선택사항)
새로운 권한 목록 (선택사항)
새로운 신뢰 호스트 (선택사항)
modifyThirdPartyAccessOnAccommodation
특정 숙박 시설에 대한 서드파티 접근 권한을 설정합니다.GraphQL Signature
파라미터
숙박 시설 ID
서드파티 이름
접근 허용 여부
응답
설정 성공 여부
사용 흐름
SMS 인증 흐름
- 인증번호 요청:
requestSMSAuth로 SMS 발송 - 사용자 입력: 고객이 SMS로 받은 인증번호 입력
- 인증 확인:
confirmSMSAuth로 검증 및 authHash 발급 - 회원가입/비밀번호 변경: authHash를 사용하여 계정 생성 또는 비밀번호 변경
OTP 설정 흐름
- OTP 키 생성:
setOtpKey로 QR 코드 발급 - OTP 앱 등록: Google Authenticator 등에서 QR 코드 스캔
- OTP 활성화:
lockOtpKey로 OTP 코드 검증 및 활성화
익명 로그인 흐름
- 로그인 요청:
requestAnonymousSignIn으로 토큰 발급 - 승인 대기:
waitAnonymousSignIn으로 승인 대기 - 승인 처리: 관리자가
anonymousSignIn으로 승인
관련 API
- 사용자 API - 회원가입 및 비밀번호 변경
- Core 인증 API - 마일리지 SMS 인증