3. API Rate Limit

Parameter Description

설명	Rate Limit란 특정한 시간 내에 호출할 수 있는 API 요청 횟수를 의미합니다. 클라이언트의 API 요청 횟수가 제한 값을 초과하면 HTTP 429 코드를 반환하며 요청이 실패합니다. 클라이언트에서 API Rate Limit를 고려해 적절하게 처리하지 않으면 의도하지 않은 오류가 발생할 수 있습니다. 특히, 재시도하는 로직이 있는 경우 재시도 간격을 충분히 늘려 제한 값에 도달하지 않도록 주의해야 합니다. * * API 요청 횟수는 모든 API 요청 횟수를 포함 (토큰 발급, 메시지 발송, 리포트 요청 등)

Response

Headers

HTTP/1.1 429 Too Many Requests
Content-type: application/json
RateLimit-Limit: 1000
RateLimit-Remaining: 0
RateLimit-Reset: 0.299

키	설명
RateLimit-Limit	기간 시간 내 최대 요청 가능 횟수
RateLimit-Remaining	기준 시간 내 남은 요청 가능 횟수
RateLimit-Reset	기준 시간 갱신까지 남은 시간(ms)

Body

예시)

{
"code": 5002,
"description": "too many requests",
"refkey": " test1234"
}