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

​
Path 파라미터

​
id
string
required
삭제할 운세의 ID입니다. ftn_ 접두사로 시작합니다.

​
Response

​
성공

운세 삭제에 성공하면 삭제 확인 정보가 반환됩니다.

​
실패

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

​
요청 예시

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

​
응답 예시

{
  "id": "ftn_xyz789abc123",
  "deleted": true,
  "deleted_at": "2025-01-16T15:00:00Z"
}

​
응답 필드

필드타입설명
idstring삭제된 운세의 ID입니다.
deletedboolean삭제 성공 여부입니다. 항상 true입니다.
deleted_atstring삭제 시간입니다. ISO 8601 형식입니다.

​
감사 로그

모든 삭제 작업은 감사 로그에 자동으로 기록됩니다. 
{
  "action": "fortune.deleted",
  "resource_type": "fortune",
  "resource_id": "ftn_xyz789abc123",
  "actor_ip": "203.0.113.42",
  "actor_api_key": "bs_live_xxx...",
  "metadata": {
    "profile_id": "prf_abc123def456",
    "fortune_type": "daily",
    "fortune_date": "2025-01-16"
  },
  "created_at": "2025-01-16T15:00:00Z"
}

​
일괄 삭제

여러 운세를 한 번에 삭제해야 하는 경우, 프로필 삭제를 사용하면 관련된 모든 운세가 함께 삭제됩니다. 
# 프로필 삭제 시 모든 관련 운세도 함께 삭제됨
curl -X DELETE https://api.sajuapi.dev/v1/profiles/prf_abc123def456 \
  -H "X-API-Key: bs_live_xxx"
개별 운세만 삭제하려면 이 엔드포인트를 반복 호출하세요.