Квоти та ліміти (Quotas & Limits)
Quasar Cloud вимірює використання ресурсів кожної організації в одиницях квоти (quota units). У версії Community Edition збережено аналогічний білінг, проте початкові ліміти встановлено настільки високими (баланс у 100 000 000 одиниць і ліміт у 100 000 запитів на секунду), що вони практично не обмежують роботу окремого вузла.
🧪 Публічна бета-версія
Наразі Quasar Cloud перебуває на етапі відкритого тестування і надається безкоштовно:
- Кожна нова організація отримує 1 000 безкоштовних одиниць квоти одразу після створення.
- Придбання додаткової квоти заблоковано під час бета-тесту. Якщо вашому проекту потрібно більше одиниць, надішліть запит на адресу [email protected] з поштової скриньки власника організації.
- У період бета-тестування функціонал, ліміти швидкості та розмір безкоштовної квоти можуть змінюватися.
🧮 Вартість операцій у квотах
| Операція API | Вартість (Units) |
|---|---|
Синхронізація транзакції (POST /v1/engine/pulsar/sync), Live app | 10 |
Синхронізація транзакції, Test app (sk_test_) | 5 |
| Доставка вебхука підписнику | 1 (лише за першу спробу доставки) |
Отримання історії транзакцій (GET /v1/engine/pulsar/history) | 0 (безкоштовно) |
Перевірка працездатності ноди (GET /v1/engine/monitoring/health) | 0 (публічний етап, ключ не потрібен) |
Списуються всі запити на синхронізацію, зокрема й ті, на які Quasar відповідає з прапорцем duplicate: true (коли транзакція з таким txKey вже відстежується). Повторний запит не створює дублікатів і не навантажує повторний трекінг, тому виклик onRemoteCreate залишається безпечним, але витрачає одиниці квоти.
📉 Що відбувається при вичерпанні квоти
- Синхронізація продовжує приймати транзакції, щоб жодна операція користувачів не втратилася: відповідь надходить у режимі
mode: "lazy"(код HTTP202 Acceptedзамість200 OK), і транзакція стає у чергу фонової обробки. - Усі інші запити з API ключем, зокрема запит історії транзакцій, відхиляються з помилкою
402 Payment Required, доки баланс організації не буде поповнено.
🚦 Інші ліміти платформи
| Параметр обмеження | Значення |
|---|---|
| Кількість запитів на секунду (RPS) | На організацію (5 req/s у Quasar Cloud); перевищення повертає HTTP 429 |
| Кількість транзакцій на сторінку історії | Параметр limit до 100 (за замовчуванням 10) |
| Глибина історії | Сторінки сягають 10 000 транзакцій назад; глибші сторінки відповідають 400 page_too_deep (натомість фільтруйте за статусом, мережею, гаманцем або txKey) |
| Додатків (Apps) в організації | До 30 додатків |
| Кінцевих точок вебхуків на додаток | До 20 ендпоінтів |
| Точки вебхуків на localhost | 1 на організацію (для локальної розробки через CLI) |
| Таймаут відповіді на вебхук | 10 секунд на кожну спробу доставки |
Усі синхронізовані транзакції також проходять валідацію лімітів безпеки Pulsar (граничний розмір текстових полів та об'єкта payload); за перевищення повертається помилка 400 Bad Request.