콘텐츠로 이동

속도 제한

모든 사용자에게 높은 성능과 안정성을 보장하기 위해 SMSBAT는 API 요청에 속도 제한을 적용합니다. 속도 제한은 특정 기간 내에 수행할 수 있는 최대 API 호출 수를 지정합니다.

기본 제한

계약에 달리 명시되지 않는 한 기본 속도 제한은 모든 API 엔드포인트(SMSBAT API, Cascade API 및 ChatHub API)에 적용됩니다.

API 카테고리 기본 한도 버스트 제한
메시징 끝점(/bat/messagelist) 요청 100개/초 요청 150개/초
데이터 엔드포인트(상태, 잔액, 정보) 요청 50개/초 요청 75개/초

[!참고] 아웃바운드 메시징(예: POST /bat/messagelist)의 경우 하나의 HTTP 요청은 messages 배열에 최대 5,000개의 메시지를 포함할 수 있습니다. 속도 제한은 전송된 메시지 수가 아닌 HTTP 요청 수에 적용됩니다.

속도 제한 처리

허용된 비율 제한을 초과하면 API는 HTTP '429 요청이 너무 많습니다' 상태 코드로 응답합니다.

응답 예시

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

모범 사례

속도 제한을 방지하려면 다음 모범 사례를 고려하세요.

  1. 메시지 일괄 처리: 1,000개의 SMS 메시지에 대해 1,000개의 별도 HTTP 요청을 보내는 대신 1,000개의 개체 배열이 포함된 단일 요청을 보냅니다.
  2. 지수 백오프 구현: '429' 상태 코드를 받은 경우 잠시(예: 1초) 기다렸다가 다시 시도하세요. 다시 실패하면 대기 시간을 두 배로 늘립니다(2초, 4초, 8초 등).
  3. 요청 속도 조절: 수천 개의 API 호출을 트리거하는 자동화된 스크립트를 실행하는 경우 요청 사이에 약간의 지연(예: sleep(10) 밀리초)을 도입하세요.

한도 증가 요청

사용 사례에 기본 한도보다 더 높은 처리량이 필요한 경우 증가를 요청할 수 있습니다.

  1. 전담 계정 관리자에게 문의하거나 [email protected]으로 이메일을 보내세요.
  2. 계정 ID와 예상 처리량(예: 초당 요청 500개)을 제공합니다.
  3. 사용 사례를 간략하게 설명하세요.

당사의 기술팀이 귀하의 요청을 검토하고 그에 따라 한도를 조정할 것입니다.