Ratenbegrenzungen und Kontingente – WhatsApp-Profil-API

Monatliches Kontingent pro Stufe

Burst-/pro-Sekunde-Grenzwerte

Ein Burst-Limit pro Stufe verhindert den Missbrauch durch eine einzelne Taste:

MEGA-Kunden, die dauerhaft höhere Leistungsspitzen benötigen, können über ihren zuständigen Account Manager ein individuelles Limit anfordern.

Ratenbegrenzungs-Header

Jede Antwort enthält Header in Kleinbuchstaben (RapidAPI-Konvention) zur monatlichen Quotenverfolgung:

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

429 Zu viele Anfragen

Verletzung des Burst-Limits (Anfragen zu dicht beieinander) führt zu HTTP 429 mit einem kurzen Fehlertext:

HTTP/1.1 429 Too Many Requests

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

Die Angabe „0,5 Sekunden Abstand“ entspricht dem Standardwert für minIntervalSeconds in den meisten Tarifen (entspricht 2 Anfragen pro Sekunde). Den genauen Wert für Ihren Tarif finden Sie unter /api-key-stats → roleInfo.minIntervalSeconds.

Prüfen Sie Ihr eigenes Kontingent

Der Proxy stellt GET /api-key-stats bereit – rufen Sie ihn jederzeit auf, um den Live-Zähler auszulesen:

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

Caching-Richtlinie

Profildaten werden serverseitig zwischengespeichert. Wiederholte Anfragen nach derselben Nummer innerhalb des Cache-Fensters werden aus dem Cache bedient. Um eine erneute Anfrage zu erzwingen, hängen Sie ?forceBypassCache=1 an /number/{number} an – die erneute Anfrage wird dennoch auf das Kontingent angerechnet.

Verwandt