adjust-icon

리포트 서비스 API 요청 한도

리포트 서비스 API는 서비스 가용성을 보호하고 클라이언트 간 공정한 사용을 보장하기 위해 요청 한도를 적용합니다.

요청 한도는 원본 IP 주소별로 적용됩니다.

한도

리포트 서비스 API 요청에는 다음과 같은 한도가 적용됩니다.

한도
최대 요청 속도원본 IP 주소당 초당 50개 요청
버스트 허용량원본 IP 주소당 100개 요청

짧은 시간 동안은 정상 상태의 요청 속도를 초과하는 버스트 요청이 허용될 수 있지만, 버스트 처리 용량은 요청이 라우팅되는 방식에 따라 달라집니다. 여러 클라이언트가 동일한 NAT 게이트웨이 또는 프록시를 공유하는 경우, 동일한 원본 IP 주소 한도를 공유하게 됩니다.

한도 초과

요청 한도를 초과하면 API는 429 Too Many Requests 상태를 반환합니다. 요청을 다시 시도하기 전에 잠시 기다리세요.

429 응답을 받을 가능성을 줄이려면 다음을 수행하세요.

  • 동일한 원본 IP 주소에서 발생하는 동시 요청 수를 제한합니다.
  • 지수 백오프 및 지터를 적용한 재시도 로직을 사용합니다.
  • 실패한 요청을 짧은 간격의 반복 루프에서 즉시 재시도하지 마세요.