사용자 데이터 완전 삭제 API
개발용 사용자 데이터 완전 삭제(Hard Delete) API는 등록된 사용자의 모든 데이터를 데이터베이스에서 영구적으로 삭제합니다.
주의사항
이 API는 개발 환경에서만 사용 가능하며, 한번 삭제된 데이터는 복구할 수 없습니다. 프로덕션 환경에서는 사용할 수 없도록 제한됩니다.
사용자 데이터 완전 삭제
지정된 사용자 ID의 모든 데이터를 데이터베이스에서 영구적으로 삭제합니다.
- HTTP Method:
DELETE - Path:
/de/v1/users/{userId}/data - 인증: 필요 (Bearer Token)
Headers
| Header | Type | Description | Required |
|---|---|---|---|
Authorization | Bearer {token} | JWT 액세스 토큰 | Yes |
Path Parameters
| Parameter | Type | Description | Required | Format |
|---|---|---|---|---|
userId | string | 삭제할 사용자의 고유 식별자 | Yes | UUID |
Request Body
이 API는 Request Body를 사용하지 않습니다.
Responses
| HTTP Status Code | 설명 | Error Code(s) |
|---|---|---|
200 OK | 사용자 데이터 삭제 성공 | - |
400 Bad Request | 잘못된 요청 (잘못된 userId 형식) | - |
403 Forbidden | 권한 없음 (개발 환경만 허용) | - |
404 Not Found | 사용자를 찾을 수 없음 | 7002 |
500 Internal Server Error | 서버 내부 오류 | 7004 |
200 OK - 사용자 데이터 삭제 성공
사용자 데이터가 성공적으로 삭제되면 삭제된 사용자 정보와 삭제 시각이 반환됩니다.
{
"userId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
"deletedAt": 1678886400000
}
| 필드 | 타입 | 설명 | 예시 | 필수 (Yes/No) |
|---|---|---|---|---|
userId | string | 삭제된 사용자의 ID | a1b2c3d4-e5f6-7890-1234-567890abcdef | Yes |
deletedAt | number | 데이터 삭제 작업이 처리된 타임스탬프 (Unix timestamp in milliseconds, Kotlin: Long, Swift: Int64) | 1678886400000 | Yes |
404 Not Found - 사용자를 찾을 수 없음
{
"code": 7002,
"message": "USER_NOT_FOUND",
"detail": "사용자를 찾을 수 없습니다."
}
이 오류는 지정된 userId에 해당하는 사용자가 데이터베이스에 존재하지 않을 때 발생합니다.
500 Internal Server Error - 서버 내부 오류
{
"code": 7004,
"message": "USER_DATA_HARD_DELETION_FAILED",
"detail": "사용자 데이터 영구 삭제 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요."
}
이 오류는 서버 내부에서 데이터 삭제 처리 중 예상치 못한 오류가 발생했을 때 발생합니다.
사용 예시
cURL 예시
curl -X DELETE "https://api.dta-wide.com/de/v1/users/a1b2c3d4-e5f6-7890-1234-567890abcdef/data" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
보안 고려사항
중요한 보안 정보
- 이 API는 개발 환경에서만 사용해야 합니다
- 시스템 관리자 권한이 있는 사용자만 호출할 수 있습니다
- 삭제된 데이터는 복구할 수 없으므로 신중하게 사용해야 합니다
- 프로덕션 환경에서는 대신 소프트 삭제(Soft Delete) 또는 익명화(Anonymization) 기능을 사용하세요
관련 API
변경 이력
| 버전 | 날짜 | 작성자 | 변경 내용 |
|---|---|---|---|
| 0.1.0 | 2025-07-03 | elizabeth@weltcorp.com | 최초 문서 작성 |