0) 요약

KIS / OpenDART / Naver 외부 API 호출 과정에서

연속적인 에러로 인한 API 차단 위험과 스케줄러 실패 문제를 해결하기 위해

AOP 기반으로 API·메서드별 Retry / RateLimit / CircuitBreaker 정책을 분리 적용하는 Resilience Layer 아키텍처를 설계 및 적용했습니다.

1) 문제 정의

시스템 상황

• 스케줄러 작업에서 외부 금융 API를 대량 호출
• API마다 호출 제한, 장애 패턴, 에러 성격이 모두 상이

실제 발생한 에러 유형

• KIS: 403(토큰 만료), 429(Rate Limit), 5xx
• OpenDART: 429(호출 제한), Timeout(재무데이터 미존재), 5xx
• Naver: 429, 5xx

기존 구조의 문제

• 에러 발생 시 재시도 정책 부재
• 연속 실패 시 외부 API로 요청이 지속되어 차단 위험 증가
• 하나의 API 장애가 스케줄러 전체 실패로 전파

→ 서비스 안정성과 외부 API 보호 모두 취약한 구조

2) 아키텍처 설계