Google Play에서 모바일 앱을 설치하면 더 편리하게 비볼디를 이용할 수 있습니다.

사용자 계정 정보 조회 API

인증 토큰을 기반으로 현재 사용자 계정 정보를 조회하세요.

요금제, 인증 상태, 지역 설정 등 다양한 계정 데이터를 확인하여 서비스 로직에 활용할 수 있습니다.

이 API는 퍼스널 요금제 이상에서만 사용할 수 있습니다.

GET

/api/user/v1/get

HTTP Header 
X-Access-Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

No Request Parameters

{
    "code": 0,
    "message": "",
    "result": {
        "eml": "your@gmail.com",
        "nm": "Tester",
        "planNm": "BUSINESS",
        "planExpires": "2025-12-31",
        "locale": "en_US",
        "timeZone": "America/New_York",
        "emlVerifiedYn": "Y",
        "twoAuthYn": "N",
        "sinYmdt": "2025-10-08 03:36:28",
        "regYmdt": "2019-08-13 12:13:01"
    }
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result object
eml string
사용자 이메일.
nm string
사용자 이름.
planNm string
현재 이용 중인 요금제.
planExpires date
요금제 만료일. 한국 시간(UTC +09:00) 기준 00:00 시점에 만료됩니다.
locale string
사용자 계정의 언어 및 지역.
timeZone string
표준 시간대.
언어 및 지역, 표준 시간대는 [설정 -> 프로필] 페이지에서 변경할 수 있습니다.
emlVerifiedYn string
Default:N
Enum:
YN
이메일 인증 여부.
Y: 인증 완료, N: 인증 필요.
twoAuthYn string
Default:N
Enum:
YN
2단계 인증 사용 여부.
Y: 사용 중, N: 미사용.
sinYmdt datetime
최근 로그인 일시.
regYmdt datetime
계정 생성 일시.

언제 이 API를 사용하나요?

본 API는 서비스 내 대시보드에서 사용자의 이름이나 요금제 등급을 표시해야 할 때 주로 사용됩니다.

특히 요금제 만료일(planExpires)이나 2단계 인증 사용 여부(twoAuthYn)를 확인하여, 특정 기능에 대한 접근 권한을 제어하거나 보안 강화 안내를 제공하는 로직을 구현할 때 매우 유용합니다.

응답 데이터 활용 방법

응답 데이터는 다양한 서비스 로직에 활용할 수 있습니다.

  • 요금제에 따른 기능 제한 처리
  • 인증 상태에 따른 접근 제어
  • 사용자 지역/언어 기반 UI 구성
  • 보안 설정(2FA) 기반 추가 인증 요구

즉, 이 API는 서비스 동작을 결정하는 핵심 입력 데이터로 사용됩니다.

인증 API와의 관계

본 API는 인증 API 이후에만 사용할 수 있습니다.

일반적인 흐름:

  1. 인증 API 호출 → 토큰 발급
  2. 토큰 포함 → 사용자 정보 조회

즉,

  • 인증 API → 접근 권한 확보
  • 조회 API → 사용자 데이터 활용

운영 관점에서의 중요 포인트

본 API는 단순 조회 기능이 아니라 서비스 정책과 사용자 상태를 연결하는 핵심 API입니다.

  • 요금제 기반 과금 로직
  • 보안 정책 적용
  • 사용자 경험 최적화
  • 기능 접근 제어

모든 서비스 로직의 기준 데이터로 활용됩니다.

사용 시 주의사항

  • 토큰이 만료되면 조회가 실패합니다.
  • 클라이언트에 민감한 정보를 그대로 노출하지 않도록 주의해야 합니다.
  • 캐싱 사용 시 사용자 상태 변경이 반영되지 않을 수 있습니다.
  • 인증 상태(emlVerifiedYn) 기반 분기 처리를 반드시 고려해야 합니다.