Кейс: доступ до приміщення для однієї особи із Server Approval
Вимога
Клієнту з приміщенням обмеженого доступу (наприклад, серверною, сховищем або лабораторією) потрібне було просте, але суворе правило, яке виконується біля дверей:
У приміщенні може перебувати лише одна людина одночасно. Наступну особу не можна впускати, доки поточна не відзначить вихід.
Пристрій Cams виконує перевірку особи, а Server Approval розширює це, дозволяючи вашому власному програмному забезпеченню додати зверху логіку «чи вже хтось усередині?» — і в реальному часі вирішувати, чи справді слід впустити перевіреного користувача.
Чому підходить Server Approval
За замовчуванням (Server Approval вимкнено) пристрій надає доступ одразу після локальної перевірки користувача — ваше програмне забезпечення дізнається про це постфактум. Для простого журналювання цього достатньо, але запобігти входу так не вийде.
Коли Server Approval увімкнено, пристрій після локальної перевірки робить паузу й чекає, поки ваше програмне забезпечення підтвердить відмітку, і лише тоді відчиняє двері. Саме цей обмін запитом і відповіддю дає змогу вбудувати бізнес-логіку — наприклад, «чи вже хтось усередині?» — безпосередньо в рішення про доступ, а не просто фіксувати його постфактум.
Як працює процес
- Користувач робить відмітку на пристрої.
- Пристрій перевіряє його локально, а потім надсилає JSON-запит на зареєстрований вами callback URL.
- Ваше програмне забезпечення перевіряє власний стан зайнятості та відповідає:
{"status": "done"}→ пристрій приймає відмітку й відчиняє двері.{"status": "reject"}→ пристрій відмовляє в доступі й залишає двері зачиненими.
- Під час виходу ваше програмне забезпечення оновлює стан зайнятості, щоб наступний вхід було оцінено правильно.
Покроковий приклад із двома користувачами
Користувач X входить. Пристрій перевіряє X, надсилає зворотний виклик, ваше програмне забезпечення бачить, що приміщення порожнє, і повертає done. X заходить. Ваше програмне забезпечення позначає приміщення як зайняте.
Користувач Y намагається увійти, поки X ще всередині. Пристрій перевіряє Y і надсилає зворотний виклик — так само, як і для будь-якої іншої відмітки. Ваше програмне забезпечення бачить, що приміщення все ще зайняте, і повертає reject. Пристрій відмовляє Y, і двері лишаються зачиненими. Y не впустять, доки ваше програмне забезпечення не вирішить інакше.
X виходить. Ваше програмне забезпечення фіксує вихід і скидає прапорець зайнятості.
Y пробує ще раз. Той самий процес зворотного виклику, але цього разу ваше програмне забезпечення бачить, що приміщення вільне, і повертає done. Y заходить.
Роль пристрою ніколи не змінюється — він завжди перевіряє особу й питає ваше програмне забезпечення, що робити далі. Єдине, що відрізняє «reject» від «done», — це те, що ваше програмне забезпечення знає про те, хто зараз усередині.
Примітки щодо впровадження
- Перевірка зайнятості повністю лежить на вашому боці — пристрій не пам'ятає, хто всередині. Для приміщення з одним місцем достатньо простого прапорця або запису для кожного приміщення; для кількох приміщень або більшої місткості знадобиться невелика таблиця станів із ключем за приміщенням/пристроєм.
- Переконайтеся, що події виходу фіксуються надійно, адже пропущений вихід назавжди заблокує приміщення, навіть коли користувач уже пішов.
- Протестуйте шлях зворотного виклику локально, перш ніж запускати в роботу — див. наш супутній посібник про локальне тестування зворотних викликів Cams API за допомогою інструментів тунелювання, де описано налаштування ngrok/Cloudflare Tunnel/localhost.run для вашого середовища розробки.
Що слід враховувати: підключення та відповіді зворотного виклику
Server Approval залежить від живого обміну між пристроєм і вашим сервером та від того, що ваш сервер завжди відповідає правильно. Варто врахувати дві ситуації:
Пристрій офлайн. Він не може надіслати зворотний виклик перевірки в реальному часі, тож ваше програмне забезпечення не має змоги відповісти done або reject. Пристрій показує повідомлення «Disconnected» і категорично відхиляє відмітку — він не переходить до доступу лише на локальному рівні.
Ваш зворотний виклик повертає щось інше, ніж {"status": "done"} або {"status": "reject"}. Недійсна або неочікувана відповідь застрягає в черзі, і пристрій не надсилатиме жодних подальших даних відміток на ваш callback, доки це не буде вирішено, — тож двері лишаються зачиненими не лише для цього користувача, а й для всіх після нього, доки ваш callback знову не почне відповідати правильно.
Іншими словами, гарантія «одна людина одночасно» настільки надійна, наскільки надійні мережеве підключення пристрою та відповіді вашого зворотного виклику. Для промислового впровадження враховуйте обидва чинники — наприклад, віддавайте перевагу дротовому підключенню перед Wi-Fi або налаштуйте сповіщення про тривалі періоди офлайн, а також сувору валідацію, щоб ваш callback завжди повертав коректну відповідь done/reject, навіть у гілках обробки помилок.
Результат
Завдяки увімкненому Server Approval і мінімальному прапорцю зайнятості в програмному забезпеченні клієнта вимогу «одна людина одночасно» було реалізовано повністю наявними можливостями пристрою — без додаткового обладнання та без змін на боці пристрою, окрім перемикача в конфігурації.