Limites de taxa e cotas — API de perfil do WhatsApp

Cota mensal por nível

Limites de rajada/por segundo

Um limite de pico por nível impede o abuso de uma única chave:

Clientes MEGA que necessitem de picos de dados mais elevados e contínuos podem solicitar um limite personalizado através do gerente de contas dedicado.

Cabeçalhos de limite de taxa

Cada resposta inclui cabeçalhos em letras minúsculas (convenção RapidAPI) para controle de cotas mensais:

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

429 Pedidos em Excesso

A violação do limite de requisições (requisições muito próximas umas das outras) retorna o código HTTP 429 com um corpo de erro curto:

HTTP/1.1 429 Too Many Requests

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

A indicação de intervalo de 0,5 segundos reflete o valor padrão de minIntervalSeconds na maioria dos planos (= 2 requisições/seg). Consulte /api-key-stats → roleInfo.minIntervalSeconds para obter o valor exato do seu plano.

Verifique sua própria cota

O proxy expõe o método GET /api-key-stats — chame-o a qualquer momento para ler o contador em tempo real:

{
  "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
  }
}

Política de armazenamento em cache

Os dados do perfil são armazenados em cache no servidor. Consultas repetidas para o mesmo número dentro do período de cache são atendidas a partir do cache. Para forçar uma nova consulta, adicione `?forceBypassCache=1` a `/number/{number}` — a nova solicitação ainda será contabilizada na cota.

Relacionado