Tenant + key + endpoint group
Ліміти мають рахуватися за клієнтом, ключем і групою endpoint, щоб одна інтеграція не зупинила всі інші.
Rate limits.
Правила, які захищають ресторан, API і зовнішню інтеграцію від зайвого навантаження.
Як поводитися з лімітами
Rate limits не мають бути сюрпризом для розробника. Інтеграція повинна мати backoff, кеш і зрозумілу помилку для оператора.
Backoff і Retry-After
Якщо API повертає 429 або Retry-After, інтеграція має зачекати і не запускати паралельний шторм повторів.
Кешування read-only даних
Меню, категорії і довідники не потрібно перечитувати кожну секунду. Використовуйте кеш і webhooks там, де це доречно.
Обмежені сторінки
Використовуйте limit до 100 і курсори. Не намагайтеся одним запитом забрати всю історію ресторану.
Окремі ключі
BI, мобільний застосунок і автоматизації мають різні ключі, щоб high-load integration можна було обмежити окремо.
Планові обмеження
Деякі можливості залежать від тарифу ресторану. Якщо модуль вимкнений, API має fail closed, а не частково віддавати дані.
Публічні цифри лімітів
Конкретні числові ліміти публікуються тільки після production calibration. До цього документація фіксує поведінку інтеграції: bounded pagination, backoff, кешування, розділення ключів і fail-closed модулі.Сплануйте запуск ресторану без хаосу.
Покажемо Limvero на прикладі ресторану, схожого на ваш: точки, меню, POS, кухню, QR-меню, склад, лояльність і тарифи.