Rate Limiting

Обзор

Enot Messenger использует Redis-based rate limiting для защиты от злоупотреблений и DDoS атак. Лимиты применяются на уровне IP адреса и пользователя.

Лимиты запросов

Операция	Лимит	Период	Scope
Login	5 попыток	15 минут	IP адрес
Registration	3 аккаунта	1 час	IP адрес
API Requests	100 запросов	1 минута	User ID
Messages	30 сообщений	1 минута	User ID
File Upload	10 файлов	1 минута	User ID
WebSocket Messages	60-120 сообщений	1 минута	User ID

Response Headers

При достижении лимита API возвращает следующие заголовки:

                        X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1714932000
Retry-After: 60
                    

Описание заголовков

X-RateLimit-Limit - максимальное количество запросов
X-RateLimit-Remaining - оставшееся количество запросов
X-RateLimit-Reset - Unix timestamp когда лимит сбросится
Retry-After - количество секунд до сброса лимита

Ответ при превышении лимита

HTTP Status: 429 Too Many Requests

                        {
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "details": {
    "retry_after": 60,
    "limit": 100,
    "window": "1 minute"
  }
}
                    

Важно: При получении 429 ошибки, подождите указанное в retry_after количество секунд перед следующим запросом.

Best Practices

1. Exponential Backoff

При получении 429 ошибки используйте exponential backoff:

                        async function fetchWithRetry(url, options, maxRetries = 3) {
  let retries = 0;
  let delay = 1000; // 1 second

  while (retries < maxRetries) {
    try {
      const response = await fetch(url, options);
      
      if (response.status === 429) {
        const retryAfter = response.headers.get('Retry-After');
        const waitTime = retryAfter ? parseInt(retryAfter) * 1000 : delay;
        
        console.log(`Rate limited. Waiting ${waitTime}ms...`);
        await new Promise(resolve => setTimeout(resolve, waitTime));
        
        retries++;
        delay *= 2; // Exponential backoff
        continue;
      }
      
      return response;
    } catch (error) {
      throw error;
    }
  }
  
  throw new Error('Max retries exceeded');
}
                    

2. Request Batching

Группируйте запросы вместо отправки множества мелких:

Используйте пагинацию для получения больших списков
Кэшируйте данные локально
Используйте WebSocket для real-time обновлений вместо polling

3. Мониторинг лимитов

Отслеживайте заголовки rate limit и предупреждайте пользователя:

                        const remaining = parseInt(response.headers.get('X-RateLimit-Remaining'));
const limit = parseInt(response.headers.get('X-RateLimit-Limit'));

if (remaining < limit * 0.1) {
  console.warn('Approaching rate limit:', remaining, '/', limit);
}
                    

Как избежать rate limits

Используйте WebSocket для real-time обновлений вместо polling
Кэшируйте данные локально (localStorage, IndexedDB)
Используйте пагинацию для больших списков
Группируйте операции (batch requests)
Используйте debounce/throttle для частых операций
Обрабатывайте 429 ошибки gracefully с retry logic
Не делайте запросы в циклах без задержек

🦝 Enot Messenger