Таблица Лимитов
| Эндпоинты | Лимит | Описание |
|---|
/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.