Skip to main content

​
요청 제한 등급

등급요청/분요청/일월 비용
Free10100$0
Starter601,000$29
Pro30010,000$99
Business1,000100,000$499
Enterprise협의협의문의

​
요청 제한 헤더

모든 응답에 요청 제한 정보가 포함됩니다: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1705315200
헤더설명
X-RateLimit-Limit해당 등급의 분당 최대 요청 수
X-RateLimit-Remaining현재 구간에서 남은 요청 수
X-RateLimit-Reset제한이 초기화되는 Unix 타임스탬프

​
요청 제한 응답

요청 제한을 초과하면 429 Too Many Requests 응답을 받습니다: 
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "요청 제한 초과",
    "retryAfter": 42
  }
}
Retry-After 헤더는 재시도까지 대기할 초를 나타냅니다: 
HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705315200

​
요청 제한 처리하기

​
지수 백오프

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After')) || 60;
      const delay = retryAfter * 1000 * Math.pow(2, i);  // 지수 백오프
      console.log(`요청 제한됨. ${delay}ms 후 재시도...`);
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }
  throw new Error('최대 재시도 횟수 초과');
}

​
요청 큐잉

import PQueue from 'p-queue';

// 초당 1개 요청으로 제한
const queue = new PQueue({ interval: 1000, intervalCap: 1 });

// 모든 운세 요청을 큐에 추가
async function getFortune(saju, userName) {
  return queue.add(() =>
    fetch('/api/daily-fortune', {
      method: 'POST',
      body: JSON.stringify({ saju, userName })
    })
  );
}

​
엔드포인트별 추가 제한

일부 엔드포인트는 추가 제한이 있습니다:
엔드포인트추가 제한이유
/api/daily-fortune?type=compare10회/시간높은 비용 (9번의 AI 호출)
/api/daily-fortune-stream30회/분장기 연결
/api/saju120회/분연산 집중적

​
제한 상향하기

​
플랜 업그레이드

dashboard.sajuapi.dev/billing에서 업그레이드하세요.

​
Enterprise 제한 요청

Business 등급 이상의 제한이 필요한 경우: 
curl -X POST https://api.sajuapi.dev/api/support/limit-increase \
  -H "X-API-Key: bs_live_xxx" \
  -d '{
    "requestedLimit": 5000,
    "useCase": "DAU 10만의 고트래픽 트레이딩 앱",
    "expectedVolume": "일 50만 요청"
  }'

​
모범 사례

운세 결과는 24시간 동안 유효합니다. 클라이언트 측에서 캐시하세요:
const cacheKey = `fortune_${userId}_${date}`;
const cached = localStorage.getItem(cacheKey);
if (cached) return JSON.parse(cached);
같은 날 태어난 사용자는 같은 일간(日干)을 공유합니다. 요청을 일괄 처리하세요:
// 100명의 사용자에 대해 100번 요청하는 대신:
// 고유한 일간(日干)당 1번 요청 (최대 10번)
const uniqueDayMasters = [...new Set(users.map(u => u.dayMaster))];
일일 운세 알림의 경우, 폴링 대신 웹훅 시스템을 사용하세요:
// 웹훅을 한 번만 등록
await registerWebhook({
  url: 'https://your-app.com/webhooks/fortune',
  events: ['fortune.daily']
});
한국 시간 오전 2-6시에 API 지연 시간이 낮습니다. 해당 시간에 일괄 작업을 예약하세요.

​
사용량 모니터링

실시간으로 사용량을 추적하세요: 
curl https://api.sajuapi.dev/api/usage \
  -H "X-API-Key: bs_live_xxx"

{
  "usage": {
    "today": {
      "requests": 847,
      "limit": 1000,
      "cost": 11.01
    },
    "thisMonth": {
      "requests": 15420,
      "cost": 200.46
    }
  },
  "rateLimit": {
    "current": 45,
    "limit": 60,
    "resetsAt": "2024-01-15T10:05:00Z"
  }
}