Skip to main content
DELETE
/
v1
/
profiles
/
{id}
프로필 삭제
curl --request DELETE \
  --url https://sajuapi.dev/v1/profiles/{id} \
  --header 'X-API-Key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.sajuapi.dev/llms.txt

Use this file to discover all available pages before exploring further.

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를 통해 조회할 수 있습니다.