사용량 제한 및 할당량 — WhatsApp 프로필 API

등급별 월별 할당량

버스트/초당 제한

단계별 버스트 제한을 통해 단일 키를 이용한 악용을 방지합니다.

지속적으로 더 높은 순간 최대 출력이 필요한 MEGA 고객은 전담 계정 관리자를 통해 맞춤 한도를 요청할 수 있습니다.

속도 제한 헤더

모든 응답에는 월별 할당량 추적을 위해 소문자 헤더(RapidAPI 규칙)가 포함됩니다.

x-ratelimit-requests-limit:     60000
x-ratelimit-requests-remaining: 59999
x-ratelimit-requests-reset:     2591983   # seconds until reset

429 너무 많은 요청

버스트 제한 위반(요청 간격이 너무 짧음)으로 인해 짧은 오류 본문과 함께 HTTP 429 오류가 반환됩니다.

HTTP/1.1 429 Too Many Requests

{
  "error": "Requests must be at least 0.5 seconds apart"
}

0.5초 간격이라는 문구는 대부분의 요금제에서 기본적으로 설정되는 minIntervalSeconds 값(초당 2회 요청)을 반영합니다. 정확한 값은 /api-key-stats → roleInfo.minIntervalSeconds에서 확인하세요.

본인의 할당량을 확인하세요

프록시 서버는 GET /api-key-stats 요청을 노출합니다. 이 요청을 언제든지 호출하여 실시간 카운터를 확인할 수 있습니다.

{
  "key": "08dc53d3-...",
  "role": "pro_60",
  "status": "active",
  "requestLimit": 60000,
  "requestRemaining": 59999,
  "requestReset": 2591982,
  "resetAt": "2026-05-27T02:24:56.708Z",
  "expiresAt": "2026-05-27T02:24:56.708Z",
  "lastUsedAt": "2026-04-27T02:25:12.955Z",
  "requestCountMonth": 1,
  "maxMonthlyUsage": 60000,
  "roleInfo": {
    "name": "pro_60",
    "maxMonthlyUsage": 60000,
    "minIntervalSeconds": 0.5
  }
}

캐싱 정책

프로필 데이터는 서버 측에 캐시됩니다. 캐시 기간 내에 동일한 번호를 반복적으로 조회하는 경우 캐시에서 데이터가 제공됩니다. 새로 조회하려면 /number/{number} 뒤에 ?forceBypassCache=1을 추가하세요. 새로 요청하는 경우에도 할당량에 포함됩니다.

관련된