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

Таблица Лимитов

Эндпоинты	Лимит	Описание
`/v1/*`	120 запросов/мин	Все эндпоинты API V1
`/v2/*`	120 запросов/мин	Все эндпоинты API V2
`/v1//stats/`	20 запросов/мин	API Статистики V1
`/v2//stats/`	40/120 запросов/мин	API Статистики V2 (без токена / с токеном)

Пример Ответа При Превышении Лимита

{
  "code": 5016,
  "message": "Rate Limit Exceeded",
  "retry_after": 45,
  "details": {
    "limit": 120,
    "count": 125,
    "excess": 5,
    "reset_at": 1740339600000
  }
}

Заголовки Rate Limit

API возвращает заголовки с информацией о лимитах в каждом ответе:

Заголовок	Пример значения	Описание
`X-RateLimit-Limit`	120	Максимальное количество запросов в минуту
`X-RateLimit-Remaining`	115	Оставшееся количество запросов до сброса
`X-RateLimit-Reset`	Unix timestamp	Время (мс), когда лимит будет сброшен
`Retry-After`	45	Секунд до сброса лимита (только при 429 ошибке)

Всегда используйте заголовки ограничений, возвращаемые в каждом ответе, чтобы динамически настраивать частоту запросов. Не зашивайте жёсткие значения лимитов в код — они могут меняться и отличаться в зависимости от сервиса.

Очередь Команд

Эндпоинты */command используют систему очереди:

Максимальный размер очереди: 100 команд
Интервал выполнения: 1 команда каждые 5 секунд

Когда очередь заполнена, вы получите:

{
  "code": 5015,
  "message": "Command Queue Full"
}

Защита От Спама

После превышения лимита счётчик не останавливается, а продолжает считать лишние запросы. При достижении 400 лишних запросов выдаётся бан на 5 минут. Если спам продолжается, время бана увеличивается.

API Статистики V2: Используйте токен для увеличения лимита с 40 до 120 запросов/мин. Передайте токен через заголовок Authorization: Bearer <token>.

Злостные Нарушители

Приложения, которые продолжают отправлять запросы после получения ответов 429, могут быть заблокированы на всё более длительный срок.

Приложения, которые систематически не соблюдают лимиты запросов, будут заблокированы через Cloudflare. Если вы столкнулись со страницей блокировки Cloudflare, вам необходимо связаться с нами, открыв API-тикет на Discord-сервере ER:LC, чтобы снять блокировку.

Хостинги с Общими IP-Адресами

API ER:LC Россия не поддерживает BotGhost и аналогичные хостинги с общими IP-адресами. Когда куча разных приложений работают под одним IP, они постоянно упираются в лимиты запросов друг друга, и решить эту проблему невозможно. Для стабильного доступа к API хостите свой сервис на выделенном IP.

Начало

Документация

Правила

Таблица Лимитов

Пример Ответа При Превышении Лимита

Заголовки Rate Limit

Очередь Команд

Защита От Спама

Злостные Нарушители

Хостинги с Общими IP-Адресами

​Таблица Лимитов

​Пример Ответа При Превышении Лимита

​Заголовки Rate Limit

​Очередь Команд

​Защита От Спама

​Злостные Нарушители

​Хостинги с Общими IP-Адресами

Таблица Лимитов

Пример Ответа При Превышении Лимита

Заголовки Rate Limit

Очередь Команд

Защита От Спама

Злостные Нарушители

Хостинги с Общими IP-Адресами