Admin API크리에이터 회원 관리
크리에이터 탈퇴·복구
관리자 권한으로 크리에이터를 소프트 탈퇴시키거나 복구합니다.
크리에이터 탈퇴·복구
회원 ID로 크리에이터의 목표 상태를 지정합니다. 프로필·회원 레코드를 삭제하지 않습니다.
PATCH /ai/admin/creators/{memberId}/status
Authorization: Bearer {admin_access_token}
Content-Type: application/json요청 본문
탈퇴 요청:
{"status":"WITHDRAWN","reason":"회원 요청"}복구 요청:
{"status":"ACTIVE"}| 필드 | 필수 | 설명 |
|---|---|---|
status | 예 | ACTIVE 또는 WITHDRAWN. 현재 상태를 뒤집는 토글이 아님 |
reason | 탈퇴 시 | 공백이 아닌 탈퇴 사유, 최대 2000자. 복구 시 사용하지 않음 |
대상은 auth=0인 크리에이터이며 프로필이 연결되어 있어야 합니다.
같은 상태의 재요청은 성공 응답을 반환하며 사유·일시·세션을 다시 변경하지 않습니다.
- 탈퇴: 기존 소프트 탈퇴 처리를 사용하여 상태·사유·일시를 저장하고 웹·앱 refresh 키를 삭제합니다.
- 복구: 상태를 정상으로 바꾸고 refresh 키를 삭제합니다. 기존 탈퇴 사유·일시는 보존합니다.
- 복구 후 다시 탈퇴하면 새 사유·일시로 갱신합니다. 본인 앱에서 사유 없이 재탈퇴하면 사유는 NULL입니다.
- 원본 프로필·캠페인·계약·정산·배송·블랙리스트는 변경하지 않습니다.
- 별도 상세/이력 API, 이력 테이블, 신규 컬럼은 추가하지 않습니다.
응답
{
"status": 200,
"code": null,
"message": "크리에이터 상태 변경 완료",
"data": {
"memberId": "creator-hong",
"status": "WITHDRAWN",
"withdrawalReason": "회원 요청",
"withdrawnAt": "2026-09-14T10:00:00"
}
}복구 응답은 status=ACTIVE이며 마지막 사유·일시가 유지됩니다.
| HTTP 상태 | code | 설명 |
|---|---|---|
| 400 | VALIDATION_ERROR | status 누락·잘못된 값, 탈퇴 사유 누락·공백·길이 초과 |
| 400 | REQ_001 | 크리에이터가 아니거나 프로필이 연결되지 않은 회원 |
| 401 | 인증 오류 코드 | 인증 실패 |
| 403 | 인증 오류 코드 | 관리자 권한 없음 |
| 404 | INVALID_INFLUENCE_USER | 회원 없음 |
현재 인증·연관 처리 범위
탈퇴 중에는 기존 Spring·Node 회원 상태 검사로 인증을 차단합니다. 이번 API는 refresh 키를 정리하지만 JWT 발급·검증 정책을 변경하지 않습니다. 따라서 복구 후에는 탈퇴 전에 발급된 미만료 JWT가 다시 유효해질 수 있으며, 이 API만으로 모든 이전 토큰의 영구 무효화나 재로그인 강제를 보장하지 않습니다.
기존 진행 캠페인·미정산 차단, 신규 섭외·알림 중단 정책을 추가하지 않습니다. 기존 확장프로그램 영구 삭제 경로는 별도이며, 그 경로로 이미 삭제된 계정은 이 API로 복구할 수 없습니다.