Підтримка batch-запитів

Підтримка batch-запитів

При інтеграції із зовнішніми системами важливо вмітьобробляти дані масово, без перевантаження серверів і без необхідності виконувати десятки окремих викликів. Ми реалізуємо підтримку batch-запитів - механізм, що дозволяє відправляти відразу кілька операцій в одному API-виклику.

Це особливо ефективно при роботі зі звітами, синхронізацією транзакцій, імпортом користувачів або подій.

Що таке batch-запити

Batch-запит дозволяє об'єднати кілька запитів в один:

• ```json
• [
• { “ method “ : “ POST “ , “ path “ : “ /users “ , “ body “ : { “ name “ : “ Alice “ } },
• { “ method “ : “ PUT “ , “ path “ : “ /users/42 “ , “ body “ : { “ email “ : “ new@mail. com “ } },
• { “ method “ : “ DELETE “ , “ path “ : “ /users/15 “ }
• ]
• ```

Сервер обробляє кожен з них послідовно або паралельно і повертає масив відповідей, відповідних порядку запитів.

Переваги для інтегратора

Перевага	Пояснення
Зниження навантаження	Менше HTTP-з'єднань - вище швидкість обробки
Масова синхронізація	Обробка пачок даних: транзакції, дії, об'єкти
Цілісність	Можливість обробки в одному контексті або транзакції
Простота логування	Одна точка контролю, централізована відповідь
Економія ресурсів	Менше операцій, менше часу на підтвердження і відповідь

Реалізація та особливості

Підтримка'batch []'в тілі запиту або '/batch'endpoint
Авторизація загальна або на рівні кожної операції
Валідація всіх операцій до початку виконання
Часткова або повна атомарність (за конфігурацією)
Відповіді з прив'язкою до кожного запиту (статус, тіло, помилки)

Де особливо важливо

Імпорт даних з CRM, ERP, бухгалтерії
Передача безлічі транзакцій або логів
Масові оновлення профілів, балансів, ігрових сесій
Сценарії, де важлива швидкість, цілісність і економія трафіку

Batch-запити - це ефективний спосіб скоротити кількість викликів, прискорити інтеграцію і знизити навантаження. Ми забезпечимо підтримку цього механізму на рівні API та інфраструктури - для будь-якого масштабу даних.