사용자 조회

Prev Next
This content is currently unavailable in English. You are viewing the default (Korean) version.

Classic/VPC 환경에서 이용 가능합니다.

사용자의 상세 정보를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /v2/member/{memberId}

요청 헤더

GAMEPOT 3.0 API에서 공통으로 사용하는 헤더에 대한 정보는 GAMEPOT 3.0 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
memberId String Required 사용자 아이디
  • GAMEPOT 3.0 대시보드의 사용자 > 목록에서 확인

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://dashboard-api.gamepot.ntruss.com/v2/member/faa90e5e-****-****-****-f3050b8c5013' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project ID}' \
--header 'Accept: application/json'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
id String - 사용자 아이디
deleted Boolean - 탈퇴 여부
  • true | false
    • true: 탈퇴
    • false: 탈퇴 안 함
store_id String - 스토어 아이디
country String - 접속 국가
  • ISO 3166-1 기준
remoteip String - 접속 IP 주소
nickname String - 사용자 이름
adid String - 광고 아이디(ADID)
device String - 디바이스
network String - 네트워크
version String - 버전
model String - 모델
token String - 푸시 토큰
push Boolean - 푸시 동의 여부
  • true | false
    • true: 동의
    • false: 비동의
push_date Object - 푸시 동의/비동의 일시
push_date.on String - 푸시 동의 일시
  • ISO 8601 형식
push_date.off String - 푸시 비동의 일시
  • ISO 8601 형식
night Boolean - 야간 푸시 동의 여부
  • true | false
    • true: 동의
    • false: 비동의
night_date Object - 야간 푸시 동의/비동의 일시
night_date.on String - 야간 푸시 동의 일시
  • ISO 8601 형식
night_date.off String - 야간 푸시 비동의 일시
  • ISO 8601 형식
ad Boolean - 광고성 푸시 동의 여부
  • true | false
    • true: 동의
    • false: 비동의
memo String - 사용자에 대한 메모
device_id String - 디바이스 아이디
agree Object - 약관 동의 정보
agree.termsofuse String - 이용 약관 동의 여부
  • Y | N
    • Y: 동의
    • N: 비동의
agree.termsofuseAt String - 이용 약관 동의/비동의 일시
  • ISO 8601 형식
agree.privacypolicy String - 개인정보 처리방침 동의 여부
  • Y | N
    • Y: 동의
    • N: 비동의
agree.privacypolicyAt String - 개인정보 처리방침 동의/비동의 일시
  • ISO 8601 형식
verify Object - 본인 인증 정보
verify.key String - 본인 인증 키
verify.updatedAt String - 본인 인증 일시
adult Boolean - 성인 인증 여부
gdpr Object - GDPR 약관 동의 정보
gdpr.status Integer - GDPR 상태 코드
gdpr.email_verified Boolean - 이메일 주소 인증 여부
  • true | false
    • true: 인증 완료
    • false: 인증 필요
gdpr.checked_story_category_ids Array - GDPR 관련 항목 중 체크된 항목
local Object - 로컬 인증 정보
local.status Integer - 로컬 인증 상태 코드
local.email_cert_key String - 이메일 인증 키
local.email_cert_expired_at String - 이메일 인증 만료 일시
userdata String - 사용자 데이터
createdAt String - 생성 일시
  • ISO 8601 형식
updatedAt String - 정보 수정 일시
  • ISO 8601 형식
loginedAt String - 마지막 로그인 일시
  • ISO 8601 형식
deletedAt String - 탈퇴 일시
  • ISO 8601 형식

응답 상태 코드

GAMEPOT 3.0 API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 GAMEPOT 3.0 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
  "id": "TWVtYmVyOmZh**************************************hjNTAxMw==",
  "deleted": false,
  "store_id": "apple",
  "country": "KR",
  "remoteip": "**.**.**.**",
  "nickname": null,
  "adid": "",
  "device": "IOS",
  "network": "WiFi",
  "version": "17.5.1",
  "model": "iPhone13,1",
  "token": "a9f84127**************************************************3df5e5",
  "push": true,
  "push_date": {
    "on": "2025-09-18T17:09:22+09:00",
    "off": null
  },
  "night": true,
  "night_date": {
    "on": "2025-09-18T17:09:22+09:00",
    "off": "2025-08-29T12:01:13+09:00"
  },
  "ad": true,
  "memo": null,
  "device_id": "D6057F17-****-****-****-AB98D510CC2B",
  "agree": {
    "termsofuse": "Y",
    "termsofuseAt": "2025-08-29T12:01:13+09:00",
    "privacypolicy": "Y",
    "privacypolicyAt": "2025-08-29T12:01:13+09:00"
  },
  "verify": {
    "key": null,
    "updatedAt": null
  },
  "adult": null,
  "gdpr": {
    "status": 0,
    "email_verified": null,
    "checked_story_category_ids": []
  },
  "local": {
    "status": 0,
    "email_cert_key": null,
    "email_cert_expired_at": null
  },
  "userdata": null,
  "createdAt": "2025-08-29T12:01:12+09:00",
  "updatedAt": "2025-09-18T17:09:22+09:00",
  "loginedAt": "2025-09-18T17:09:22+09:00",
  "deletedAt": null
}