사용량 제한 (Rate Limit)

사용량 제한(Rate Limit)은 특정 시간 내에 호출할 수 있는 API 요청 수를 제한하는 보안 메커니즘입니다.

기본 제한 정책

SOLAPI API는 Resource Path별로 다음과 같은 호출 제한을 적용합니다:

인증 상태	API 유형	제한	기간
인증 완료	조회 API	20회	5초
인증 완료	발송 API	100회	5초
인증 없음	모든 API	5회	5초

인증된 요청은 인증 가이드를 참고하세요.

Response Header 정보

API 요청 시 다음과 같은 Rate Limit 정보가 Response Header에 포함됩니다

Response Header

x-ratelimit-limit: 3;w=4.554;b=5
x-ratelimit-remaining: 3
x-ratelimit-reset: Mon Jul 24 2023 03:21:17 GMT+0000 (Coordinated Universal Time)
x-retry-after: 4.554

Header 필드 설명

필드	예시 값	설명
x-ratelimit-limit	3;w=4.554;b=5	남은 요청 수;남은 시간;정해진 호출제한 시간
x-ratelimit-remaining	3	현재 남은 요청 수
x-ratelimit-reset	Mon Jul 24 2023 03:21:17 GMT+0000	호출제한이 초기화되는 시간
x-retry-after	4.554	제한 초기화까지 남은 시간(초)

제한 초과 시 응답

호출 수가 제한값을 초과하면 다음과 같은 오류가 반환됩니다:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "errorCode": "TooManyRequests",
  "message": "잦은 호출로 제한되었습니다."
}

제한 상향 요청

기본 제한으로 부족한 경우, 관리자에게 계정 단위 호출제한 상향을 요청할 수 있습니다

권장 사항

• 요청 간격 조정: Rate Limit에 걸리지 않도록 적절한 간격으로 API를 호출하세요
• 배치 처리: 가능한 경우 여러 요청을 배치로 처리하여 호출 수를 줄이세요
• 캐싱 활용: 자주 조회하는 데이터는 캐싱을 통해 API 호출을 최소화하세요

---