Skip to main content
POST
https://sajuapi.dev
/
v1
/
cache
/
clear
캐시 클리어
curl --request POST \
  --url https://sajuapi.dev/v1/cache/clear \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "type": "<string>",
  "profile_id": "<string>",
  "fortune_date": "<string>",
  "confirm": true
}
'
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
캐시된 데이터를 삭제합니다. 운세 데이터, 계산 결과 등 특정 유형의 캐시를 선택적으로 삭제할 수 있습니다.
이 엔드포인트는 관리자 권한이 필요합니다. 캐시 삭제 후 일시적으로 응답 시간이 증가할 수 있습니다.

​
Request Body 파라미터

​
type
string
default:"all"
삭제할 캐시 유형입니다. all, fortunes, calculations, profiles 중 하나입니다.
​
profile_id
string
특정 프로필의 캐시만 삭제합니다. 지정하지 않으면 전체를 대상으로 합니다.
​
fortune_date
string
특정 날짜의 운세 캐시만 삭제합니다. ISO 8601 형식(YYYY-MM-DD)입니다.
​
confirm
boolean
required
캐시 삭제를 확인합니다. true로 설정해야 삭제가 진행됩니다.

​
Response

​
성공

캐시 삭제에 성공하면 삭제된 항목 수가 반환됩니다.

​
실패

상태 코드에러 타입설명
400validation_errorconfirm 파라미터가 누락됨
401authentication_errorAPI 키가 유효하지 않음
403forbidden관리자 권한이 없음
429rate_limited요청 한도 초과

​
요청 예시

# 전체 캐시 삭제
curl -X POST https://api.sajuapi.dev/v1/cache/clear \
  -H "X-API-Key: bs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "all",
    "confirm": true
  }'

# 특정 프로필 캐시만 삭제
curl -X POST https://api.sajuapi.dev/v1/cache/clear \
  -H "X-API-Key: bs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "fortunes",
    "profile_id": "prf_abc123def456",
    "confirm": true
  }'

# 특정 날짜의 운세 캐시 삭제
curl -X POST https://api.sajuapi.dev/v1/cache/clear \
  -H "X-API-Key: bs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "fortunes",
    "fortune_date": "2025-01-16",
    "confirm": true
  }'

​
응답 예시

​
전체 캐시 삭제

{
  "success": true,
  "type": "all",
  "cleared": {
    "fortunes": 12580,
    "calculations": 5420,
    "profiles": 0
  },
  "cleared_count": 18000,
  "cleared_at": "2025-01-16T09:00:00Z"
}

​
특정 프로필 캐시 삭제

{
  "success": true,
  "type": "fortunes",
  "profile_id": "prf_abc123def456",
  "cleared": {
    "fortunes": 45
  },
  "cleared_count": 45,
  "cleared_at": "2025-01-16T09:00:00Z"
}

​
특정 날짜 캐시 삭제

{
  "success": true,
  "type": "fortunes",
  "fortune_date": "2025-01-16",
  "cleared": {
    "fortunes": 3250
  },
  "cleared_count": 3250,
  "cleared_at": "2025-01-16T09:00:00Z"
}

​
CacheClearResult 객체

필드타입설명
successboolean삭제 성공 여부입니다.
typestring삭제된 캐시 유형입니다.
profile_idstring대상 프로필 ID입니다 (지정한 경우).
fortune_datestring대상 날짜입니다 (지정한 경우).
clearedobject유형별 삭제된 항목 수입니다.
cleared_countinteger총 삭제된 항목 수입니다.
cleared_atstring삭제 완료 시간입니다.

​
캐시 유형

유형설명TTL
fortunes생성된 운세 캐시24시간 (일간), 1주일 (연간)
calculations사주 계산 결과 캐시영구 (프로필 삭제 시 삭제)
profiles프로필 조회 캐시1시간

​
활용 사례

​
운세 재생성

프로필 정보가 수정된 후 캐시를 삭제하여 새로운 운세를 생성할 수 있습니다. 
// 프로필 수정 후 캐시 삭제
async function updateProfileAndClearCache(profileId, updateData) {
  // 1. 프로필 수정
  await fetch(`/v1/profiles/${profileId}`, {
    method: 'PUT',
    headers: {
      'X-API-Key': 'bs_live_xxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(updateData)
  });

  // 2. 해당 프로필의 캐시 삭제
  await fetch('/v1/cache/clear', {
    method: 'POST',
    headers: {
      'X-API-Key': 'bs_live_xxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      type: 'fortunes',
      profile_id: profileId,
      confirm: true
    })
  });

  // 3. 새로운 운세 생성
  const fortune = await fetch('/v1/fortunes', {
    method: 'POST',
    headers: {
      'X-API-Key': 'bs_live_xxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      profile_id: profileId,
      fortune_type: 'daily'
    })
  }).then(r => r.json());

  return fortune;
}

​
일괄 캐시 초기화

자정에 모든 일간 운세 캐시를 삭제하여 새로운 날의 운세를 준비할 수 있습니다. 
// 자정에 실행 (Cron job)
async function resetDailyCache() {
  const yesterday = new Date();
  yesterday.setDate(yesterday.getDate() - 1);
  const dateStr = yesterday.toISOString().split('T')[0];

  const result = await fetch('/v1/cache/clear', {
    method: 'POST',
    headers: {
      'X-API-Key': 'bs_live_xxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      type: 'fortunes',
      fortune_date: dateStr,
      confirm: true
    })
  }).then(r => r.json());

  console.log(`어제(${dateStr}) 캐시 삭제: ${result.cleared_count}개`);
}
캐시 삭제는 감사 로그에 기록됩니다. 빈번한 캐시 삭제는 비용 증가로 이어질 수 있으므로 주의하세요.