회원 수정
회원 정보 · 상태 · 등급 · 메모 · 수신 동의를 보낸 필드만 고칩니다.
수정
PATCH
https://api.mallstory.kr/v1/shop/{shop_unique}/members/{member_unique}권한 customers:write
보낸 필드만 바뀝니다. 응답은 {member, changed} 입니다.
요청 본문
| 필드 | 형식 | 설명 |
|---|---|---|
name | string | 이름 |
email | string | 메일 |
mobile | string | 휴대폰(숫자만) |
birth | string | 생년월일(YYYY-MM-DD) |
address | object | null | {zipcode, address1, address2} |
status | string | 회원 상태. 정지하면 그 회원의 쇼핑몰 로그인 · 회원 토큰이 끊깁니다. 탈퇴로는 바꿀 수 없습니다 코드값 |
level_unique | string | 회원등급 키(회원 등급의 level_unique) |
memo | string | 판매자 메모(회원에게 보이지 않음) |
consent_email | boolean | 이메일 광고 수신 동의. 바뀔 때만 동의 이력에 남습니다(출처: 외부 앱) |
consent_sms | boolean | 문자 광고 수신 동의 |
bash요청
curl -X PATCH 'https://api.mallstory.kr/v1/shop/6a9515bdcb3ab5179ba767ad/members/6accb17807e52ce89536610b' \
-H 'Authorization: Bearer msat_8Hk2wQ7...' \
-H 'Content-Type: application/json' \
-d '{"memo":"API 시험 메모","consent_sms":true}'json200 OK
{
"member": {
"member_unique": "6accb17807e52ce89536610b",
"consent_sms": {
"agreed": true,
"at": "2026-10-12T10:08:19.579Z"
},
"memo": "API 시험 메모",
"…": "상세와 같은 필드"
},
"changed": [
"memo",
"consent_sms"
]
}비밀번호 · 아이디 · 탈퇴 · 적립금은 고칠 수 없습니다 — 쇼핑몰 관리자에서 합니다.
json400 — status 를 LEAVE 로 보냄
{
"code": "InvalidParameterValue",
"message": "탈퇴 처리는 API 로 할 수 없습니다. 쇼핑몰 관리자에서 하세요."
}오류
| 상태 | code | 언제 |
|---|---|---|
| 400 | InvalidParameterValue | 고칠 수 없는 필드 · 형식 오류 · 탈퇴(LEAVE) |
| 404 | MemberNotExist | 없는 키이거나 이 쇼핑몰 회원이 아님 |
| 401 | MissingLoginSession | Authorization 헤더에 Bearer 토큰이 없음 |
| 401 | InvalidAccessToken | 토큰이 틀리거나 만료 · 폐기됨 |
| 403 | InsufficientScope | 토큰에 customers:write 가 없음 |