Rate-limiting для API Бітрікс24: уникаємо QUERY_LIMIT_EXCEEDED

Ми часто стикаємося з ситуацією: інтеграція працює, дані синхронізуються — а потім у п'ятницю ввечері скрипт починає слати запити в циклі без пауз, впирається в ліміт, отримує помилку QUERY_LIMIT_EXCEEDED і падає. Або гірше — не падає, а повторює запит негайно, погіршуючи ситуацію. API Бітрікс24 має жорсткі rate limits, і будь-яка інтеграція зобов'язана їх враховувати. Інакше — втрата даних, розсинхронізація, блокування застосунку. Наш досвід показує: правильне налаштування rate-limiting економить години налагодження та запобігає інцидентам. Наша команда має 10+ років досвіду розробки на Бітрікс24 і реалізувала понад 50 інтеграцій, тому ми знаємо всі підводні камені. У цій статті ми розберемо ліміти REST API Бітрікс24, методи оптимізації та конкретні сценарії, які ми реалізуємо для клієнтів. Ви дізнаєтеся, як уникнути типових помилок і побудувати стійку інтеграцію.

Які ліміти встановлені в API Бітрікс24?

Бітрікс24 застосовує обмеження на двох рівнях:

При перевищенні ліміту API повертає HTTP 503 з тілом {"error":"QUERY_LIMIT_EXCEEDED"}. Повторний запит рекомендується через 500 мс — але не одразу. Добовий ліміт скидається о 00:00 за часом порталу. Для застосунків з маркетплейсу ліміти відрізняються і залежать від підписки розробника.

Як метод batch допомагає обійти ліміти?

batch — головний інструмент економії запитів. Один виклик batch містить до 50 команд і вважається як один запит:

POST https://your-domain.bitrix24.by/rest/batch/
cmd[0]=crm.deal.list?filter[STAGE_ID]=WON
cmd[1]=crm.deal.list?filter[STAGE_ID]=LOSE
cmd[2]=crm.contact.list?filter[TYPE_ID]=CLIENT

Команди всередині batch виконуються послідовно. Можна використовувати результати попередніх команд через $result:

cmd[0]=crm.deal.get?id=123
cmd[1]=crm.contact.get?id=$result[0][CONTACT_ID]

Batch-запити дозволяють виконати до 50 операцій за один запит — це в 50 разів ефективніше за послідовні виклики. Замість 50 окремих запитів (25 секунд при 2 req/sec) — один запит за 1-2 секунди.

Порівняння стратегій управління лімітами

Exponential backoff — при отриманні QUERY_LIMIT_EXCEEDED повторювати запит із збільшуваною затримкою: 500 мс → 1 с → 2 с → 4 с. Максимум 5 спроб, потім — помилка в лог.

Черга запитів — замість прямих викликів API запити ставляться в чергу (Redis, RabbitMQ, БД). Воркер розбирає чергу, дотримуючись інтервалу 500 мс між запитами. Це виключає ситуацію, коли два процеси одночасно шлють запити і сумарно перевищують ліміт.

Token bucket — програмний лічильник: застосунок відстежує кількість запитів за останню секунду і блокує відправлення до звільнення слоту. Реалізується через shared state (Redis) для розподілених систем.

Також застосовуйте розділення за часом: важкі синхронізації (повне вивантаження угод, оновлення каталогу) виконуйте вночі, коли користувачі не працюють з API.

Як вибрати стратегію управління лімітами?

Вибір стратегії залежить від навантаження та архітектури. Для простих сценаріїв достатньо exponential backoff — він не вимагає додаткових сервісів. Якщо інтеграція високонавантажена (більше 10 запитів в секунду сумарно), використовуйте чергу запитів на Redis — вона гарантує дотримання лімітів навіть при конкурентних запитах. Token bucket підходить для розподілених систем, де кілька мікросервісів звертаються до одного порталу.

Що входить в роботу

• Архітектура інтеграції з урахуванням rate limits: batch-запити, черги, backoff
• Воркер для послідовної обробки API-запитів з контролем швидкості
• Перехід з одиночних запитів на batch для масових операцій
• Моніторинг витрати API-лімітів та алерти при наближенні до порогу
• Рознесення навантаження: фонові синхронізації в непіковий час
• Діагностика та усунення помилок QUERY_LIMIT_EXCEEDED
• Документація за налаштованою інтеграцією

Оцінка проєкту — безкоштовно. Якщо ви зіткнулися з помилками QUERY_LIMIT_EXCEEDED або хочете оптимізувати API-інтеграцію, зв'яжіться з нами. Наші сертифіковані фахівці мають багаторічний досвід роботи з Бітрікс24 і гарантують стабільність ваших інтеграцій. Отримайте консультацію — ми допоможемо усунути вузькі місця та запобігти простоям.

Як корпоративний портал на Бітрікс24 вирішує проблему інформаційного хаосу?

Ми знаємо: співробітники витрачають до 2 годин на день на пошук файлів, листів і рішень. Завдання губляться в десятку чатів, погодження застряють на тижні. Керівник дізнається про зрив дедлайну лише на нараді. Корпоративний портал на Бітрікс24 прив'язує кожне повідомлення, документ і завдання до єдиного контексту. Ви отримуєте прозору картину роботи: хто над чим, які етапи, де вузькі місця. Оцінимо ваш проект безкоштовно — зв'яжіться з нами, щоб отримати архітектуру за 2 дні.

Що дає портал у щоденній роботі і чому це краще месенджерів?

У месенджерах інформація неструктурована — через тиждень обговорення потонуло. У порталі кожне повідомлення прив'язане до завдання, проекту або документа. Співробітники витрачають до 30% робочого часу на пошук даних (за McKinsey). Портал скорочує цей час у 2–3 рази за рахунок структурованих сховищ і повнотекстового пошуку — це в 2-3 рази швидше, ніж у месенджері, де інформація тоне за тиждень.

Комунікації. Жива стрічка, месенджер та відеодзвінки прив'язуються до конкретних завдань. Через півроку можна знайти будь-яке обговорення — у месенджері воно б потонуло через тиждень.

Завдання та проекти. Канбан, Гант, чеклісти, залежності, облік часу. Ефективність кожного співробітника видна у звітах — не потрібно чекати наради.

Документообіг. Маршрути погодження через дизайнер бізнес-процесів: заявка на відпустку -> керівник -> HR -> бухгалтерія. Електронний підпис, версіонування, контроль термінів. Інтеграція з електронним документообігом (СБІС, Діадок) через REST API.

HR. Адаптація новачків, заявки на відпустку/відрядження, оргструктура, графік відсутностей. Співробітник з першого дня знає, куди йти.

База знань. Wiki-движок Бітрікс24: регламенти, інструкції. Знання не йдуть зі звільненими.

Приклад із впровадження. Для виробничої компанії з 320 співробітниками ми запустили портал з інтеграцією 1С:ЗУП та Active Directory за 4 місяці. Час погодження заявок на відрядження скоротився з 3 днів до 4 годин. Економія на простої співробітників — близько 1,2 млн грн на рік. Керівники отримують автоматичні звіти з ефективності підрозділів. Термін відповіді клієнтам зменшився на 20%. Окупність порталу — 7 місяців.

Як інтеграція з 1С та Active Directory прискорює кадровий облік?

Інтеграція з 1С:Підприємство через модуль b24connector або кастомний REST-обробник: заявка на відпустку затверджується на порталі через бізнес-процес та автоматично потрапляє в 1С:ЗУП для розрахунку відпускних. Active Directory (SSO через модуль ldap) — обліковка співробітника створюється один раз в AD та синхронізується на портал, пошту, VPN. При звільненні блокується всюди. Ручне створення акаунтів виключено, помилки мінімізовані.

Типи корпоративних порталів та ключові інтеграції

Додаткові інтеграції, що дають реальну цінність:

• Пошта. Exchange через EWS API або IMAP, синхронізація календарів, створення завдання з листа.
• IP-телефонія. Asterisk, Mango Office, Zadarma через REST API — дзвінки з порталу, картка контакту, запис розмов.
• Відеоконференції. Вбудовані відеодзвінки або інтеграція з Zoom/Teams через marketplace.
• ЕДО. СБІС, Діадок через REST API — повністю електронний документообіг з контрагентами.

Безпека та відповідність 152-ФЗ

На порталі — персональні дані, фінансова звітність, стратегічні плани. Ми гарантуємо захист:

• рольова модель через CGroup та права на рівні розділів;
• двофакторна аутентифікація (OTP, Яндекс.Ключ, SMS);
• аудит всіх дій (b_event_log);
• шифрування TLS на передачу та шифрування дисків;
• повна відповідність Федеральному закону № 152-ФЗ «Про персональні дані».

Як відбувається впровадження? Покроковий план

1. Аудит — фіксуємо поточні процеси, вимірюємо втрати часу.
2. Проектування — обираємо тип порталу, плануємо інтеграції.
3. Реалізація — налаштовуємо бізнес-процеси, права, інтерфейс.
4. Тест — пілотна група перевіряє сценарії, ми виправляємо недоліки.
5. Запуск — підключаємо всіх співробітників, навчаємо, передаємо документацію.

Що входить у роботу

В результаті ви отримуєте:

• проектну документацію (архітектура, схеми бізнес-процесів, технічне завдання);
• налаштований портал з інтеграціями (1С, AD, пошта, телефонія, ЕДО);
• опис бізнес-процесів та інструкції для адміністраторів і користувачів;
• 30 днів технічної підтримки після запуску.

Підтримка після запуску: як не дати порталу померти

Через півроку багато порталів стають занедбаними. Щоб цього уникнути, пропонуємо пакети з фіксованим SLA та виділеним адміністратором. Моніторинг продуктивності, оновлення платформи, адміністрування користувачів, доопрацювання нових модулів. Досвід нашої команди — понад 50 впроваджень корпоративних порталів на Бітрікс24, 10+ років роботи, статус сертифікованого партнера 1С-Бітрікс. Гарантуємо якість та терміни.

Мобільний доступ. Нативний додаток Бітрікс24 (iOS/Android) з push-сповіщеннями, завданнями, чатами. Адаптивний веб-інтерфейс для екстранет-користувачів (не треба встановлювати додаток). Офлайн-доступ до документів та завдань, синхронізація при відновленні зв'язку.

Замовте впровадження корпоративного порталу під ключ

Зв'яжіться з нами — оцінимо ваш проект, запропонуємо архітектуру та терміни. Отримайте консультацію безкоштовно та переконайтеся, що портал окупається в перші півроку. Замовляйте впровадження та почніть автоматизацію вже сьогодні.