Skip to main content

요청 한도

Octoparse MCP 서버는 OAuth 세션당 분당 최대 300개 요청을 허용합니다. 이 한도는 검색, 실행, 내보내기 및 작업 관리를 포함한 모든 MCP 도구 호출에 적용됩니다.

한도를 초과하면 발생하는 일

요청 한도를 초과하면 서버에서 HTTP 429 Too Many Requests를 반환합니다.
고정된 대기 시간에 의존하지 말고 아래 응답 헤더를 사용해 재시도 시점을 결정하세요.

재시도 헤더

헤더설명
X-RateLimit-Limit현재 요청 한도 구간에서 허용되는 최대 요청 수입니다.
X-RateLimit-Remaining현재 구간에 남은 요청 수입니다.
X-RateLimit-Reset현재 구간이 재설정되는 시점을 나타내는 ISO 8601 타임스탬프입니다. 다음으로 안전하게 재시도할 시간을 결정할 때 사용하세요.
X-RateLimit-Window현재 요청 한도 구간의 길이(밀리초)입니다.

권장 처리 방법

1

상태 코드 확인

서버가 429를 반환하면 영구 실패가 아니라 요청 한도 적용으로 처리하세요.
2

재시도 헤더 확인

X-RateLimit-RemainingX-RateLimit-Reset을 확인하여 현재 구간이 소진되었는지와 재설정 시점을 파악하세요.
3

재설정 후 재시도

다음 요청을 보내기 전에 X-RateLimit-Reset에 표시된 시간까지 기다리세요.