관리자 API회원 관리소유자 토큰

회원 상세

회원 한 명을 가리지 않은 값과 판매자 메모까지 읽습니다.

상세

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/members/{member_unique}

권한 customers:read

가리지 않은 값이 옵니다. 판매자 메모(memo)도 함께 옵니다 — 회원 본인 API 에는 나가지 않는 칸입니다. 값이 없는 칸(메일 · 휴대폰 등)은 응답에서 빠집니다.

bash요청

curl 'https://api.mallstory.kr/v1/shop/6a9515bdcb3ab5179ba767ad/members/6accb17807e52ce89536610b' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'

json200 OK

{
  "member_unique": "6accb17807e52ce89536610b",
  "member_no": 11,
  "login_id": "e2eprod",
  "provider": "LOCAL",
  "name": "상품시험",
  "status": "ACTIVE",
  "level": {
    "level_unique": "6aa0e089fc6e77ca0e475eef",
    "name": "플래티넘"
  },
  "address": null,
  "consent_email": {
    "agreed": false,
    "at": null
  },
  "consent_sms": {
    "agreed": false,
    "at": null
  },
  "point": 0,
  "created": "2026-10-12T10:07:52.337Z",
  "last_login_at": null,
  "memo": ""
}

응답 필드

필드	형식	설명
`member_unique`	string	회원 키. 경로에 넣는 값(사용자에게 보여 줄 때는 member_no · login_id)
`member_no`	number	회원번호
`login_id`	string \| null	아이디. 소셜 로그인으로만 가입한 회원은 null
`provider`	string	가입 경로 코드값
`name`	string	이름
`email`	string	메일
`mobile`	string	휴대폰(숫자만)
`birth`	string	생년월일(YYYY-MM-DD)
`status`	string	회원 상태 코드값
`level.level_unique`	string \| null	회원등급 키(회원 등급)
`level.name`	string	회원등급 이름
`address`	object \| null	주소. 없으면 null
`address.zipcode`	string	우편번호
`address.address1`	string	기본주소
`address.address2`	string	상세주소
`consent_email.agreed`	boolean	이메일 광고 수신에 동의했는가
`consent_email.at`	ISO \| null	동의 · 철회한 시각
`consent_sms.agreed`	boolean	문자 광고 수신에 동의했는가
`consent_sms.at`	ISO \| null	동의 · 철회한 시각
`point`	number	적립금
`created`	ISO	가입 시각
`last_login_at`	ISO \| null	마지막 로그인 시각
`memo`	string	판매자 메모(관리자 토큰에만)

오류

상태	code	언제
404	`MemberNotExist`	없는 키이거나 이 쇼핑몰 회원이 아님
401	`MissingLoginSession`	Authorization 헤더에 Bearer 토큰이 없음
401	`InvalidAccessToken`	토큰이 틀리거나 만료 · 폐기됨
403	`InsufficientScope`	토큰에 customers:read 가 없음

상세#

응답 필드

오류

상세