Skip to main content
DELETE
https://sajuapi.dev
/
v1
/
profiles
/
{id}
프로필 삭제
curl --request DELETE \
  --url https://sajuapi.dev/v1/profiles/{id} \
  --header 'X-API-Key: <api-key>'
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
프로필을 삭제합니다. 삭제된 프로필과 연관된 모든 운세 데이터도 함께 삭제됩니다.
이 작업은 되돌릴 수 없습니다. 삭제된 데이터는 복구할 수 없으며, 모든 삭제 작업은 감사 로그에 기록됩니다.

​
Path 파라미터

​
id
string
required
삭제할 프로필의 ID입니다. prf_ 접두사로 시작합니다.

​
Response

​
성공

프로필 삭제에 성공하면 삭제된 프로필 정보와 삭제 확인이 반환됩니다.

​
실패

상태 코드에러 타입설명
401authentication_errorAPI 키가 유효하지 않음
404not_found프로필을 찾을 수 없음
429rate_limited요청 한도 초과

​
요청 예시

curl -X DELETE https://api.sajuapi.dev/v1/profiles/prf_abc123def456 \
  -H "X-API-Key: bs_live_xxx"

​
응답 예시

{
  "id": "prf_abc123def456",
  "deleted": true,
  "deleted_at": "2025-01-16T15:00:00Z",
  "related_data_deleted": {
    "fortunes": 45,
    "cached_calculations": 12
  }
}

​
응답 필드

필드타입설명
idstring삭제된 프로필의 ID입니다.
deletedboolean삭제 성공 여부입니다. 항상 true입니다.
deleted_atstring삭제 시간입니다. ISO 8601 형식입니다.
related_data_deletedobject함께 삭제된 연관 데이터 정보입니다.
related_data_deleted.fortunesinteger삭제된 운세 데이터 수입니다.
related_data_deleted.cached_calculationsinteger삭제된 캐시된 계산 결과 수입니다.

​
감사 로그

모든 삭제 작업은 감사 로그에 자동으로 기록됩니다. 
{
  "action": "profile.deleted",
  "resource_type": "profile",
  "resource_id": "prf_abc123def456",
  "actor_ip": "203.0.113.42",
  "actor_api_key": "bs_live_xxx...",
  "metadata": {
    "fortunes_deleted": 45,
    "cached_calculations_deleted": 12
  },
  "created_at": "2025-01-16T15:00:00Z"
}
감사 로그는 리포트 API를 통해 조회할 수 있습니다.