문서/요청 한도

요청 한도

API 요청 한도, 크레딧 사용량, 속도 제한을 깔끔하게 처리하는 방법을 알아보세요.

Markdown 보기 OpenAPI JSON

현재 한도

영역한도의미
API 키 요청분당 60회, 하루 5,000회 요청인증된 API 키의 기본 할당량이에요.
/api/batch요청당 최대 500개 이메일요청당 이메일 한도 안에서 배치를 보내세요.
익명 검사기IP 주소당 하루 5회 검사계정 API 키 없이 공개 검사기를 쓸 때 적용돼요.
검증 처리량계정의 사용 가능한 크레딧크레딧에 따라 실행할 수 있는 검증 건수가 정해져요.
대량 CSV 업로드파일 속 모든 이메일만큼 크레딧 필요업로드하려면 검증할 이메일 수만큼 크레딧이 충분해야 해요.

요청 할당량과 크레딧은 별개로 관리돼요. API 키의 기본값은 분당 60회, 하루 5,000회 요청이에요. 이 할당량은 인증된 연동이 API를 얼마나 빠르게 호출할 수 있는지를 정하고, 계정 크레딧은 실행할 수 있는 검증 건수를 정해요.

대용량 리스트 작업에서는 /api/batch 가 한 번의 요청으로 최대 500개 이메일을 받아요. 대량 CSV 업로드는 요청 횟수가 아니라 크레딧으로 관리돼요. 검증 작업을 실행하려면 업로드한 파일의 이메일 수만큼 계정에 크레딧이 있어야 해요.

공개 익명 검사기는 IP 주소당 하루 5회로 제한돼요. 계정 잔액 규칙은 다음을 참고하세요: 크레딧 및 사용량. 대용량 리스트를 가져올 때는 대량 검증을 사용하고, 연동 동작은 다음 문서를 확인하세요: 오류 처리, 빠른 시작, 요금제.

요청 한도 초과 응답

API 키가 요청 할당량을 초과하면 API는 다음 응답을 반환해요: 429 Too Many Requests . 응답에는 Retry-After 가 포함되어 있어, 클라이언트가 재시도 전에 얼마나 기다려야 하는지 알 수 있어요.

json
{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please retry after the indicated delay.",
  "status_code": 429,
  "retry_after": 15
}

Retry-After 헤더

반면 Retry-After 응답 헤더는 할당량을 초과한 API 키 요청을 재시도하기 전 몇 초를 기다려야 하는지 알려 줘요:

http
HTTP/1.1 429 Too Many Requests
Retry-After: 15
Content-Type: application/json

코드에서 요청 한도 처리하기

먼저 헤더를 읽고, 표시된 시간(초)만큼 기다린 뒤 재시도하세요. 헤더가 없다면 넉넉한 기본 대기 시간을 사용하세요.

python
import requests, time

def verify_with_retry(email, api_key, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(
            "https://verimails.com/api/verify/single",
            headers={"Authorization": f"Bearer {api_key}"},
            json={"email": email}
        )

        if response.status_code == 200:
            return response.json()

        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 15))
            print(f"Rate limited. Waiting {retry_after}s...")
            time.sleep(retry_after)
            continue

        response.raise_for_status()

    raise Exception("Max retries exceeded")

권장 사항

© 2026 VeriMails™ — 엔터프라이즈 이메일 검증. All rights reserved.