API 속도 제한(Rate Limit) 오류 해결 방법

API 속도 제한 오류가 발생했습니다. 이 오류는 짧은 시간 내에 너무 많은 API 요청을 보냈을 때 발생합니다. 구체적으로 deeplink API의 1분당 100회 제한을 초과했으며, 2025-05-20T03:17:57.862454562 이후에 다시 시도하라는 메시지입니다.

오류 원인

이 오류는 API 사용량 제한(Rate Limit)에 의해 발생했습니다:

• deeplink API는 1분당 100회로 요청이 제한되어 있습니다
• 현재 1회 초과했으며, 총 3회 초과 시 파트너스 이용이 제한됩니다
• API 제공자는 서버의 안정성과 성능을 유지하기 위해 이러한 제한을 설정합니다

해결 방법

즉시 할 수 있는 조치

1. 지정된 시간까지 대기: 오류 메시지에 명시된 시간(2025-05-20T03:17:57.862454562) 이후에 다시 시도하세요
2. API 호출 횟수 모니터링: 현재 1회 초과 상태이므로, 추가 위반이 발생하지 않도록 주의하세요

장기적 해결책

1. 지수 백오프(Exponential Backoff) 구현:

• API 요청 실패 시 점진적으로 대기 시간을 늘리는 방식으로 재시도
• 일시적인 오류로 인한 실패를 효과적으로 처리할 수 있습니다

1. 요청 횟수 제한 및 관리:

• 일괄 처리(Batch Processing)를 통해 여러 요청을 하나로 통합
• API 호출 간 지연 시간 추가
• 불필요한 API 호출 최소화

1. 캐싱 활용:

• 반복적인 질문에 대해 동일한 응답을 제공하는 경우 캐싱을 활용해 API 요청 줄이기
• 중복 요청 감소 및 성능 향상 가능

1. 동적 속도 제한 조정:

• 서버 부하에 따라 요청 속도를 자동으로 조정
• 서버 로드, 트래픽 양, 응답 시간 등을 고려한 유연한 접근 방식 적용

권장 구현 방법

import time
import random

def api_request_with_backoff(max_retries=5):
    for attempt in range(max_retries):
        try:
            # API 요청 실행
            response = make_api_request()
            return response
        except RateLimitExceededError:
            if attempt == max_retries - 1:
                raise
            
            # 지수 백오프: 2^시도 횟수 + 약간의 무작위성
            wait_time = (2 ** attempt) + random.uniform(0, 1)
            print(f"{wait_time}초 대기 후 재시도...")
            time.sleep(wait_time)

이러한 전략을 구현하면 API 호출 제한을 효과적으로 관리하고 시스템 안정성을 유지하면서 필요한 기능을 계속 사용할 수 있습니다.