API 인증키 · 사용량

사용량과 호출 한도

테스트(test) 인증키에는 계정당 월 1,000회의 호출 한도가 있습니다. 운영(live) 인증키에는 한도가 없습니다. 사용량은 API 인증키 화면에서 언제든 확인하실 수 있습니다.

사용량 확인하기

API 인증키 메뉴에서 인증키 목록 바로 위에 「이번 달 호출량」 이 표시됩니다. 발급받으신 인증키가 있는 환경만 줄로 나옵니다.

이번 달 호출량 · 2026년 9월          9/8부터 집계

  test    1,240회 / 1,000회   ▓▓▓▓▓▓▓▓▓▓  초과
                              9/14 12:03 부터 막혀 있습니다

  live   52,318회             월 한도 없음

  호출량은 계정 단위로 합산됩니다 — 인증키를 여러 개 발급해도 한도는 하나입니다.
  테스트와 운영은 따로 집계됩니다.

표시	뜻
1,240 / 1,000회	이번 달 사용량과 한도입니다
월 한도 없음	운영 인증키입니다. 집계만 하고 차단하지 않습니다
2026-10-08부터 적용	아직 한도가 적용되지 않는 기간입니다. 그때까지는 차단되지 않습니다
키마다 한도가 다릅니다	일부 인증키에 별도 한도가 적용되어 있습니다. 문의 주시면 확인해 드립니다
9/8부터 집계	이 달은 집계를 도중에 시작해 온전한 한 달이 아닙니다

어떻게 세나요

계정 단위로 합산합니다 인증키를 여러 개 발급하셔도 한도는 하나입니다. 이벗WMS 와 이벗매니저를 함께 쓰셔도 합쳐서 셉니다.
다만 테스트와 운영은 따로 셉니다 — 운영 호출이 테스트 한도를 깎지 않습니다.

API 호출 한 번이 1회입니다. 조회든 등록이든 같습니다
매월 1일 0시에 초기화됩니다. 따로 신청하실 것이 없습니다
인증키가 확인된 뒤의 호출을 셉니다. 호출이 실패해도(400·404 등) 횟수에 포함되지만, 인증키가 잘못되어 거절된 호출은 세지 않습니다

한도에서 몇 건 넘어가는 경우가 있습니다 여러 호출이 동시에 들어오면 화면에 「1,003 / 1,000회」 처럼 한도를 조금 넘겨 표시될 수 있습니다. 고객님께 유리한 방향의 오차이니 그대로 두셔도 됩니다.

기록하는 것은 횟수와 시각뿐입니다 무엇을 조회하셨는지, 어떤 데이터가 오갔는지는 호출량 측정을 위해 기록하지 않습니다. 기록은 해당 월이 끝난 뒤 3년 동안 보관하고 파기합니다. 자세한 내용은 개인정보처리방침 을 확인해 주세요.

한도 안내 메일

가입하신 이메일로 아래 두 가지 안내를 보내 드립니다.

언제	내용
한도의 80%	「월 호출 한도의 80%를 사용하셨습니다」 — 남은 횟수를 함께 알려 드립니다
한도 도달	「월 호출 한도를 모두 사용하셨습니다」 — 차단 시각과 대처 방법을 안내합니다

80% 안내가 없이 바로 도달 안내가 올 수 있습니다 안내는 하루에 한 번 확인해 보내 드립니다. 하루 사이에 80%를 지나 한도까지 쓰시면 도달 안내만 갑니다.
실시간 사용량은 화면에서 언제든 보실 수 있습니다.

한도를 넘기면

테스트 인증키의 호출이 HTTP 429 로 거절됩니다. 응답 본문의 코드는 RATE_LIMIT_EXCEEDED 입니다.

이럴 때	이렇게 하시면 됩니다
운영에 쓰고 계셨다	구독하시고 운영(live) 인증키로 바꾸십시오. 운영 키에는 한도가 없습니다
아직 개발 중이다	다음 달 1일에 초기화됩니다. 급하시면 문의해 주세요
생각보다 빨리 소진되었다	같은 키로 여러 프로그램이 동시에 호출하고 있지 않은지, 재시도가 반복되고 있지 않은지 확인해 주세요
한도를 늘리고 싶다	help@ebut.co.kr 로 문의해 주세요

한도에 걸려도 인증키는 살아 있습니다 키가 폐기되거나 값이 바뀌지 않습니다. 다음 달이 되면 아무것도 하지 않으셔도 다시 호출하실 수 있습니다.

프로그램에서 남은 횟수 확인하기

한도가 적용되는 요청의 응답에는 남은 횟수를 알려주는 헤더가 함께 옵니다. 자세한 사용법은 API 문서 · Rate Limits 에 있습니다.

X-RateLimit-Limit:     1000        이번 달 허용량
X-RateLimit-Remaining: 738         남은 호출 수
X-RateLimit-Reset:     ...         초기화 시각 (다음 달 1일 0시)

한도를 넘겨 429 로 거절될 때는 아래가 함께 옵니다
Retry-After:           1209600     다시 호출할 수 있을 때까지 남은 초

운영 인증키 응답에는 이 헤더가 없습니다 한도가 적용되지 않아 알려 드릴 잔여량이 없기 때문입니다. 프로그램에서는 헤더가 없을 때도 정상 동작하도록 만들어 주세요.