Limiti di utilizzo e quote — API del profilo WhatsApp

Quota mensile per livello

Limiti di burst/al secondo

Un limite di burst per livello impedisce abusi derivanti da una singola chiave:

I clienti MEGA che necessitano di picchi di traffico elevati e costanti possono richiedere un limite personalizzato tramite il responsabile account dedicato.

Intestazioni limite di velocità

Ogni risposta include intestazioni in minuscolo (convenzione RapidAPI) per il monitoraggio delle quote mensili:

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

429 Troppe richieste

Violazione del limite di burst (richieste troppo ravvicinate) restituisce HTTP 429 con un corpo di errore breve:

HTTP/1.1 429 Too Many Requests

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

La dicitura "0,5 secondi di intervallo" riflette il valore predefinito di minIntervalSeconds sulla maggior parte dei piani (= 2 richieste/sec). Controlla /api-key-stats → roleInfo.minIntervalSeconds per il valore esatto del tuo piano.

Verifica la tua quota

Il proxy espone il metodo GET /api-key-stats: chiamalo in qualsiasi momento per leggere il contatore in tempo reale:

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

Politica di caching

I dati del profilo vengono memorizzati nella cache lato server. Le ricerche ripetute dello stesso numero all'interno della finestra di cache vengono gestite dalla cache stessa. Per forzare una nuova ricerca, aggiungi ?forceBypassCache=1 a /number/{number}: la nuova richiesta verrà comunque conteggiata ai fini della quota.

Imparentato