Ліміти Запитів

Таблиця Лімітів

Ендпоінти	Ліміт	Опис
`/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-Адресами