Mall StoryDevelopers
Mall Story
회원 API회원 토큰

회원 본인

회원이 동의한 토큰으로 그 회원 자신의 정보를 보고 고칩니다. 외부에서 만든 쇼핑몰 화면 · 회원용 앱이 씁니다.

무엇인가요

회원 토큰으로 그 회원 자신의 정보를 다룹니다. 경로에 회원 번호가 없습니다 — 토큰이 정합니다.

  • 토큰은 쇼핑몰 자신의 화면이면 회원 로그인, 남의 서비스면 회원 동의로 받습니다. 어느 쪽이든 같은 회원 토큰입니다.
  • 회원이 정지 · 탈퇴되면 살아 있는 토큰도 바로 401 입니다.
  • 판매자 메모는 나가지 않습니다. 다른 회원 정보 · 비밀번호는 다룰 수 없습니다.

내 정보

GEThttps://api.mallstory.kr/v1/me

권한 me:read

bash요청
curl 'https://api.mallstory.kr/v1/me' \
  -H 'Authorization: Bearer msat_9Kq...(회원 토큰)'
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": true,
    "at": "2026-10-12T10:08:19.579Z"
  },
  "point": 0,
  "created": "2026-10-12T10:07:52.337Z",
  "last_login_at": "2026-10-12T10:08:19.701Z"
}

응답 필드

필드형식설명
member_uniquestring회원 키. 경로에 넣는 값(사용자에게 보여 줄 때는 member_no · login_id)
member_nonumber회원번호
login_idstring | null아이디. 소셜 로그인으로만 가입한 회원은 null
providerstring가입 경로 코드값
namestring이름
emailstring메일
mobilestring휴대폰(숫자만)
birthstring생년월일(YYYY-MM-DD)
statusstring회원 상태 코드값
level.level_uniquestring | null회원등급 키(회원 등급)
level.namestring회원등급 이름
addressobject | null주소. 없으면 null
address.zipcodestring우편번호
address.address1string기본주소
address.address2string상세주소
consent_email.agreedboolean이메일 광고 수신에 동의했는가
consent_email.atISO | null동의 · 철회한 시각
consent_sms.agreedboolean문자 광고 수신에 동의했는가
consent_sms.atISO | null동의 · 철회한 시각
pointnumber적립금
createdISO가입 시각
last_login_atISO | null마지막 로그인 시각

오류

상태code언제
403Forbidden소유자 토큰으로 부름 — 회원 토큰이 필요합니다
401MissingLoginSessionAuthorization 헤더에 Bearer 토큰이 없음
401InvalidAccessToken토큰이 틀리거나 만료 · 폐기됨
403InsufficientScope토큰에 me:read 가 없음

내 정보 수정

PATCHhttps://api.mallstory.kr/v1/me

권한 me:write

보낸 필드만 바뀝니다. 응답은 {member, changed} 입니다.

요청 본문

필드형식설명
emailstring메일
addressobject | null{zipcode, address1, address2}
consent_emailboolean이메일 광고 수신 동의. 바뀔 때만 동의 이력에 남습니다(출처: 회원 본인)
consent_smsboolean문자 광고 수신 동의
bash요청
curl -X PATCH 'https://api.mallstory.kr/v1/me' \
  -H 'Authorization: Bearer msat_9Kq...(회원 토큰)' \
  -H 'Content-Type: application/json' \
  -d '{"email":"hong@example.com","consent_email":true}'
json200 OK
{
  "member": {
    "member_unique": "6accb17807e52ce89536610b",
    "consent_email": {
      "agreed": true,
      "at": "2026-10-12T10:08:19.829Z"
    },
    "…": "내 정보와 같은 필드"
  },
  "changed": [
    "email",
    "consent_email"
  ]
}
json400 — 고칠 수 없는 필드(name)
{
  "code": "InvalidParameterValue",
  "message": "고칠 수 없는 필드입니다: name. 고칠 수 있는 필드: email, address, consent_email, consent_sms"
}
  • 이름 · 휴대폰 · 생년월일은 휴대폰 본인확인 값과 엮여 있어 쇼핑몰 화면에서 본인확인 후 고칩니다.
  • 비밀번호 · 아이디 · 탈퇴는 쇼핑몰 화면에서 합니다.

오류

상태code언제
400InvalidParameterValue고칠 수 없는 필드 · 형식 오류(message 에 고칠 수 있는 필드 목록)
403Forbidden소유자 토큰으로 부름
401MissingLoginSessionAuthorization 헤더에 Bearer 토큰이 없음
401InvalidAccessToken토큰이 틀리거나 만료 · 폐기됨
403InsufficientScope토큰에 me:write 가 없음