요청 속도 제한 & 오류
요청 속도 제한, 응답 헤더, 오류 코드를 이해하세요.
플랜별 요청 속도 제한
| 플랜 | 일일 한도 | 버스트 한도 |
|---|
| Free | 200 | 1 req / 3s |
| Trader | 10,000 | 1 req / s |
| Business | 100,000 | 3 req / s |
응답 헤더
모든 API 응답에는 사용량을 추적할 수 있는 요청 속도 제한 헤더가 포함됩니다.
X-RateLimit-Limit현재 윈도우에서 허용되는 최대 요청 수.
X-RateLimit-Remaining현재 윈도우에서 남은 요청 수.
모범 사례
- •응답 캐싱 — 카드 데이터와 가격은 매 초 바뀌지 않습니다. 최소 5분간 캐싱하세요.
- •배치 조회 사용 — 개별 호출 대신
ids 파라미터를 사용해 요청당 최대 20장의 카드를 가져오세요. - •지수 백오프 구현 — 429를 받으면 대기하고 증가하는 지연으로 재시도하세요(1초, 2초, 4초).
- •요청 속도 제한 헤더 모니터링 —
X-RateLimit-Remaining을 확인해 한도에 도달하기 전에 선제적으로 속도를 줄이세요.