사용 규칙
레이트리밋
회원·키·IP·엔드포인트 네 축으로 한도를 적용합니다. 한도 초과는 차단되며 추가 과금되지 않습니다.
기본 한도
| 분당 요청 | 60 |
| 일 요청 | 10,000 |
| 월 응답 행 | 5,000,000 |
| 동시 요청 | 5 |
| 연결 매장 수 | 10 |
| 조회 기간 | 1회 31일 |
| 페이지 크기 | 기본 100 · 최대 1000 |
계약에 따라 상향 조정할 수 있습니다. 현재 한도는 사용량 API 로 확인하세요.
응답 헤더
모든 응답에 포함
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 41
X-RateLimit-Reset: 1756789012
X-RateLimit-Cost: 1X-RateLimit-Reset 은 한도가 회복되는 Unix 시각입니다. X-RateLimit-Cost 는 이 호출이 몇 건으로 계산되었는지를 알려줍니다.
가중치
통계는 원시 조회보다 비싸므로 호출 1회가 여러 건으로 계산됩니다.
| 원시 조회 (페이지 1개) | 1 |
| /stats/labor · /stats/weekday-distribution | 3 |
| /stats/hourly-distribution · /stats/staff | 5 |
| /stats/schedule-adherence | 10 |
429 처리
429 Too Many Requests
Retry-After: 17
{
"error": {
"code": "rate_limited",
"message": "요청 한도를 초과했습니다.",
"request_id": "req_01J8XQ..."
}
}!
Retry-After 를 존중하세요
즉시 재시도를 반복하면 이상 트래픽으로 판단되어 계정이 정지될 수 있습니다.
지수 백오프에 지터를 더해 재시도하세요.
자동 정지
아래 신호가 감지되면 계정이 자동으로 정지되고 등록된 이메일로 알림이 갑니다.
- 짧은 시간에 연결 시도 실패가 급증
- 평소 대비 호출량이 비정상적으로 증가
- 4xx 응답 비율 급등 (스캔·퍼징으로 판단)
- 여러 IP 에서 같은 키가 동시에 사용됨
i
정지는 키가 아니라 회원 단위입니다
새 키를 발급해 우회할 수 없습니다. 정상적인 사용 중 정지되었다면 지원으로 문의하세요.