원활한 서비스 제공을 위하 API는 일정 횟수 이상의 요청을 제한합니다
요청 횟수 제한
Rate Limit 초과 시 해당 요청은 실패 처리됩니다.시간이 지나면 호출 횟수가 자동으로 갱신됩니다. 과도한 API 사용은 예고 없이 제한될 수 있습니다.
| 구분 | 제한 횟수 |
|---|---|
| 분당 | 300건 |
| 시간당 | 10,000건 |
남은 호출 수 확인
API 응답 Header를 통해 현재 남은 호출 수와 재설정까지 남은 시간을 확인할 수 있습니다.
| Header | 설명 |
|---|---|
X-Rate-Limit-Remaining | 분당 제한 기준 남은 호출 수 |
X-Rate-Limit-Retry-After-Seconds | 호출 횟수 재설정까지 남은 시간 (초) |
응답 Header 예시
X-Rate-Limit-Remaining: 287
X-Rate-Limit-Retry-After-Seconds: 43
안정적인 연동을 위한 권장사항
X-Rate-Limit-Remaining값이 낮아질 경우 요청 빈도를 줄이시기 바랍니다.- 대량 발송이 필요한 경우
start-bulkAPI를 활용하면 요청 횟수를 줄일 수 있습니다.- Rate Limit 초과가 반복될 경우 이싸인온팀에 문의하시기 바랍니다.