Limity i kwoty przepustowości — API profilu WhatsApp

Miesięczny limit na poziom

Limity serii/na sekundę

Limit wybuchu na poziom zapobiega nadużyciom przy użyciu jednego klucza:

Klienci MEGA, którzy potrzebują stałego, wyższego limitu, mogą poprosić o niestandardowy limit za pośrednictwem dedykowanego menedżera konta.

Nagłówki limitu szybkości

Każda odpowiedź zawiera nagłówki pisane małymi literami (konwencja RapidAPI) umożliwiające śledzenie miesięcznych limitów:

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

429 Zbyt wiele żądań

Naruszenie limitu pakietów (żądania wysyłane zbyt blisko siebie) powoduje zwrócenie kodu HTTP 429 z krótkim tekstem błędu:

HTTP/1.1 429 Too Many Requests

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

Sformułowanie „0,5 sekundy odstępu” odzwierciedla domyślny minIntervalSeconds w większości planów (= 2 req/s). Sprawdź /api-key-stats → roleInfo.minIntervalSeconds, aby uzyskać dokładną wartość dla swojego planu.

Sprawdź swój własny limit

Serwer proxy udostępnia funkcję GET /api-key-stats — można ją wywołać w dowolnym momencie, aby odczytać licznik na żywo:

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

Polityka buforowania

Dane profilu są buforowane po stronie serwera. Powtarzające się wyszukiwania tego samego numeru w oknie buforowania są obsługiwane z pamięci podręcznej. Aby wymusić ponowne wyszukiwanie, należy dodać ?forceBypassCache=1 do /number/{number} — nowe żądanie nadal będzie wliczane do limitu.

Powiązany