요청 속도 제한 & 오류

요청 속도 제한, 응답 헤더, 오류 코드를 이해하세요.

플랜별 요청 속도 제한

모든 API 응답에는 사용량을 추적할 수 있는 요청 속도 제한 헤더가 포함됩니다.

X-RateLimit-Limit현재 윈도우에서 허용되는 최대 요청 수.

X-RateLimit-Remaining현재 윈도우에서 남은 요청 수.

•응답 캐싱 — 카드 데이터와 가격은 매 초 바뀌지 않습니다. 최소 5분간 캐싱하세요.
•배치 조회 사용 — 개별 호출 대신 ids 파라미터를 사용해 요청당 최대 20장의 카드를 가져오세요.
•지수 백오프 구현 — 429를 받으면 대기하고 증가하는 지연으로 재시도하세요(1초, 2초, 4초).
•요청 속도 제한 헤더 모니터링 — X-RateLimit-Remaining을 확인해 한도에 도달하기 전에 선제적으로 속도를 줄이세요.