Limites de débit et quotas — API de profil WhatsApp

Quota mensuel par niveau

Limites de rafale par seconde

Une limite de rafales par niveau empêche les abus liés à une seule clé :

Les clients MEGA ayant besoin d'une capacité de pointe plus élevée et soutenue peuvent demander une limite personnalisée via leur gestionnaire de compte dédié.

En-têtes de limitation de débit

Chaque réponse inclut des en-têtes en minuscules (convention RapidAPI) pour le suivi mensuel des quotas :

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

429 Trop de requêtes

Une violation de la limite de requêtes (requêtes trop rapprochées) renvoie une erreur HTTP 429 avec un corps d'erreur court :

HTTP/1.1 429 Too Many Requests

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

L'intervalle de 0,5 seconde correspond à la valeur par défaut de minIntervalSeconds pour la plupart des forfaits (soit 2 requêtes/seconde). Consultez la propriété roleInfo.minIntervalSeconds de la page /api-key-stats pour connaître la valeur exacte de votre forfait.

Vérifiez votre propre quota

Le proxy expose la requête GET /api-key-stats — appelez-la à tout moment pour lire le compteur en temps réel :

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

Politique de mise en cache

Les données de profil sont mises en cache côté serveur. Les recherches répétées pour un même numéro dans la fenêtre de cache sont servies depuis le cache. Pour forcer une nouvelle recherche, ajoutez `?forceBypassCache=1` à `/number/{number}` ; cette nouvelle requête est tout de même comptabilisée dans le quota.

En rapport