Ограничения скорости и квоты — API профилей WhatsApp

Ежемесячная квота по уровням

Ограничения по количеству импульсов/в секунду

Ограничение на количество использований в секунду для каждого уровня предотвращает злоупотребления с помощью одного ключа:

Клиенты MEGA, которым требуется стабильно высокий пиковый уровень трафика, могут запросить индивидуальный лимит через персонального менеджера по работе с клиентами.

Заголовки ограничения скорости

Каждый ответ содержит заголовки, написанные строчными буквами (согласно соглашениям RapidAPI), для отслеживания ежемесячной квоты:

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

429 Слишком много запросов

Нарушение лимита запросов (слишком частые запросы) возвращает HTTP-код 429 с коротким телом ошибки:

HTTP/1.1 429 Too Many Requests

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

Указание на интервал в 0,5 секунды отражает значение minIntervalSeconds по умолчанию для большинства тарифных планов (= 2 запроса/сек). Точное значение для вашего тарифного плана можно найти в файле /api-key-stats → roleInfo.minIntervalSeconds.

Проверьте свою квоту

Прокси-сервер предоставляет доступ к запросу GET /api-key-stats — вызывайте его в любое время, чтобы прочитать показания счетчика в реальном времени:

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

Политика кэширования

Данные профиля кэшируются на стороне сервера. Повторные запросы на поиск одного и того же номера в течение периода кэширования обрабатываются из кэша. Чтобы принудительно выполнить новый запрос, добавьте параметр ?forceBypassCache=1 к /number/{number} — новый запрос все равно будет учитываться в рамках квоты.

Связанный