Skip to main content
DELETE
/
v1
/
fortunes
/
{id}
운세 삭제
curl --request DELETE \
  --url https://sajuapi.dev/v1/fortunes/{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입니다. 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"
개별 운세만 삭제하려면 이 엔드포인트를 반복 호출하세요.