Webhooks проти polling: як біометричні дані в режимі реального часу мають надходити на ваш сервер
Кожна інтеграція біометрії має відповісти на одне просте питання: як скан на вході стає записом у вашій системі? Є два способи. Ваш сервер може постійно запитувати пристрій, чи не сталося чогось нового, це polling. Або система може повідомити ваш сервер одразу, коли щось відбулося, це webhook. Для даних про відвідуваність і доступ вибір між webhooks і polling впливає на те, наскільки актуальні ваші дані, яке навантаження створюється на пристрої та мережі, і наскільки надійні ваші записи. Цей посібник простими словами пояснює обидва підходи, показує, чому webhooks є кращим типовим вибором для біометричних даних, описує, як побудувати надійний приймач webhook, і пояснює, де polling досі має сенс.
01 · Pull проти Push
Два способи передачі даних
Уявіть, що ви чекаєте на важливу посилку. Ви можете кожні п'ять хвилин виходити до вхідних дверей, щоб перевірити, чи її принесли. Або ви можете чекати, поки задзвонить дзвінок. Обидва способи дадуть вам посилку. Але перший забирає багато поїздок і все одно може спізнитися на п'ять хвилин. Другий повідомляє вам у мить, коли посилка прибула.
Саме в цьому полягає різниця між polling і webhooks.
Polling: ваш сервер постійно питає
|
Ваш сервер Питає: чи є нові скани після останнього разу? |
→ |
Пристрій або система Відповідає: нічого нового |
→ |
Очікування Пауза на інтервал опитування |
→ |
Повтор Питати знову і знову цілий день |
Webhook: система повідомляє ваш сервер
|
Скан працівника Підтверджений скан відбитка пальця, обличчя або картки |
→ |
Шлюз Одразу надсилає подію на ваш URL webhook |
→ |
Ваш сервер Отримує подію і відповідає done |
→ |
Готово Без очікування і без зайвих запитів |
| Polling | Webhooks | |
|---|---|---|
| Хто ініціює обмін | Ваш сервер | Система, у якій є дані |
| Коли надходять дані | Під час наступного опитування, із затримкою до повного інтервалу | Одразу після скану |
| Запити, коли нічого не відбувається | Постійні, більшість порожні | Немає |
| Навантаження на пристрої та мережу | Постійне, незалежно від активності | Лише тоді, коли є що надіслати |
| Складність для вас | Відстеження того, що вже отримано | Прийом і підтвердження подій |
02 · Приховані витрати
Чому polling погано працює з біометричними даними
Polling добре працює для даних, які змінюються повільно або для яких затримка не має значення. Дані про відвідуваність і доступ біометрією протилежні. Вони з'являються короткими сплесками на початку та наприкінці зміни, більшу частину часу майже не змінюються і часто потрібні негайно.
Затримка закладена в самій схемі
При polling найбільша можлива затримка завжди дорівнює вашому інтервалу опитування. Скан, який стався за одну секунду після опитування, чекатиме весь інтервал, перш ніж ваш сервер його побачить.
| Інтервал опитування | Найбільша затримка до того, як система дізнається | Достатньо для |
|---|---|---|
| Раз на 24 години | До цілого дня | Лише місячна зарплата |
| Щогодини | До 60 хвилин | Денні звіти |
| Кожні 5 хвилин | До 5 хвилин | Більшість панелей, але не сповіщень |
| Щохвилини | До 60 секунд | Майже реальний час, але з високою вартістю запитів |
| Webhook | Без затримки опитування | Живі панелі, сповіщення та автоматизації |
Більшість запитів марні
Щоб наблизитися до реального часу, ви опитуєте частіше. Але більшість цих запитів нічого не повертають. Опитування одного пристрою щохвилини означає 1 440 запитів на пристрій на добу. Для 50 пристроїв це 72 000 запитів на добу, більшість з яких ставлять питання, відповідь на яке: «нічого нового». Кожен із цих запитів використовує пропускну здатність мережі та час обробки пристрою.
Облік стає крихким
Інтеграція з polling має пам'ятати, що вже отримано, зазвичай зберігаючи час або позицію останнього побаченого запису. Якщо цей маркер неправильний через перезапуск, різницю в часі між сервером і пристроєм або записи, збережені під час офлайн-роботи пристрою, інтеграція або пропускає скани, або імпортує їх двічі. Ці проблеми непомітні й часто виявляються лише під час суперечки щодо зарплати.
Із кожним майданчиком стає складніше
З одним пристроєм polling керувати можна. Але коли є десятки пристроїв на кількох майданчиках і різних брендів, кожен зі своїм підключенням, власним інтервалом і власним маркером останнього отриманого запису, polling перетворюється на окреме завдання з планування та моніторингу.
|
Polling ставить те саме питання тисячі разів на день, щоб зловити кілька важливих моментів. Webhooks повідомляють лише тоді, коли щось справді відбулося. |
03 · Push-доставка з Cams
Як працюють біометричні webhooks
У Cams Biometrics Gateway доставка через webhook називається Callback API. Ви вказуєте Gateway URL на вашому сервері, і кожен підтверджений скан надсилається на цей URL одразу, коли відбувається. Події Callback доставляються без затримки для пристроїв із Native Push.
Що отримує ваш сервер
|
Callback API, запит, який Gateway надсилає на ваш URL webhook {
"RealTime": {
"OperationID": "9nu1wak5616p",
"LabelName": "Burj Khalifa",
"SerialNumber": "ZHM11xxxxxxxx",
"PunchLog": {
"Type": "CheckOut",
"Temperature": "36.8",
"FaceMask": false,
"InputType": "Fingerprint",
"UserId": "2",
"LogTime": "2020-09-17 07:48:22 GMT +0530"
},
"AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
"Time": "2020-09-17 04:19:03 GMT +0000"
}
}
|
| Поле | Що це повідомляє вашому серверу |
|---|---|
| OperationID | Унікальний ідентифікатор цієї події |
| LabelName | Назва майданчика або дверей, до яких призначено пристрій |
| SerialNumber | Конкретний пристрій, який зафіксував скан |
| Type | Це був вхід чи вихід |
| InputType | Як людина пройшла верифікацію: відбиток пальця, обличчя, картка, PIN-код тощо |
| UserId | Хто відсканувався, відповідає ідентифікатору у вашій HR-системі |
| LogTime | Коли відбувся скан на пристрої, з урахуванням зсуву часового поясу |
| AuthToken | Токен, за яким ваш сервер підтверджує, що запит справжній |
| Time | Позначка часу самого повідомлення, у GMT |
Що має повернути ваш сервер
Щойно ваш сервер отримав подію, він відповідає коротким підтвердженням. Це повідомляє Gateway, що подію отримано безпечно.
|
Callback API, відповідь, яку має повернути ваш webhook { "status": "done" }
|
|
Push, навіть коли пристрій не може Не кожен пристрій може самостійно надсилати дані. Деякі старі або неверифіковані пристрої лише зберігають відвідуваність у локальній базі даних або файлі. З Cams Hybrid Push Gateway може читати цю базу даних (DB Pull) або стежити за файлом (File Processing) і все одно доставляти нові записи відвідуваності на ваш Callback URL. Ваш сервер отримує push-доставку в будь-якому разі, навіть якщо пристрій, на якому це працює, зазвичай потребував би опитування. |
04 · Найкращі практики
Побудова надійного приймача webhook
Приймач webhook простий у побудові, але кілька практик відрізняють той, що працює під час тестування, від того, що працює щодня роками.
| Практика | Що робити | Чому це важливо |
|---|---|---|
| Спочатку підтвердіть | Одразу після отримання події відповідайте зі статусом done, а повільнішу обробку виконуйте потім | Запит Gateway залишається коротким, навіть якщо ваші подальші системи працюють повільно |
| Ставте роботу в чергу | Кожну отриману подію поміщайте в чергу або таблицю та обробляйте окремо | Справляється зі сплесками на початку зміни без втрати подій |
| Перевіряйте AuthToken | Перевіряйте токен у кожному запиті, перш ніж довіряти даним | Не дає стороннім надсилати фальшиву відвідуваність на ваш URL |
| Використовуйте HTTPS | Відкривайте ваш webhook лише через HTTPS, за бажанням з шифруванням AES-256 від Gateway | Дані про відвідуваність є персональними даними і мають бути захищені під час передачі |
| Забезпечте ідемпотентність | Використовуйте OperationID, щоб виявляти та ігнорувати події, які ви вже обробили | Повторна доставка ніколи не стає дублікатом запису відвідуваності |
| Довіряйте LogTime для відвідуваності | Фіксуйте відвідуваність за LogTime, а не за часом, коли ваш сервер отримав подію | Події, збережені під час збою, надходять пізніше, але зберігають справжній час скану |
| Сортуйте за LogTime | Упорядковуйте події за LogTime перед розрахунком годин | Події, збережені в буфер, можуть прийти не за порядком після розриву з'єднання |
| Ведіть журнал усього | Зберігайте запис кожної отриманої події та кожної надісланої відповіді | Спрощує усунення несправностей і аудити |
|
Плануйте на піки, а не на середні значення На майданчику з 300 працівниками протягом більшої частини дня може майже нічого не надходити, а потім за десять хвилин під час зміни надходить 300 подій. Розробляйте приймач із розрахунком на цей пік. Найпростіший спосіб його обробити: швидко підтверджувати отримання і ставити роботу в чергу. |
Де може розміщуватися webhook
Вашому webhook потрібна публічна HTTPS-адреса, до якої Gateway може звернутися. Це може бути кінцева точка у вашому власному застосунку, невелика хмарна функція або вхідний webhook в інструменті автоматизації, наприклад n8n або Make. Самим пристроям публічна IP-адреса не потрібна. Майданчики за брандмауерами можуть підключатися до Gateway через Hybrid Connector, який працює через вихідне з'єднання.
|
Ваша система вирішує, що буде далі Gateway доставляє перевірені події та чекає на ваше підтвердження. Що відбувається далі, наприклад запис у вашу HRMS, оновлення панелі, надсилання повідомлення про запізнення або запуск робочого процесу, вирішують ваше програмне забезпечення та правила. |
05 · Використання обох підходів разом
Де polling досі має місце
Webhooks мають бути типовим вибором для живих біометричних даних. Але отримання даних на запит все ще виконує корисні, конкретні завдання. Найкращі інтеграції використовують webhooks для доставки в реальному часі, а запити на отримання даних за потреби — для перевірки та відновлення.
| Ситуація | Найкращий підхід | Чому |
|---|---|---|
| Жива відвідуваність, панелі, сповіщення | Webhooks (Callback API) | Дані надходять у момент скану |
| Ваш сервер був офлайн певний час | Отримати журнали на запит | Заповнює будь-який пропуск і підтверджує, що нічого не втрачено |
| Нічна або щотижнева звірка | Отримувати журнали за розкладом | Порівняння з тим, що доставили webhooks, як страхувальна сітка |
| Налаштування нової інтеграції | Отримати історичні журнали один раз | Імпортувати наявну історію до того, як webhooks візьмуть на себе роботу |
| Аудит конкретного періоду | Отримати журнали за цей період | Формує повний запис для перевірки |
Для цих завдань Cams RESTful API містить операції для завантаження журналів з пристроїв. Коли такий запит використовується рідко і свідомо, отримання журналів доповнює webhooks, а не конкурує з ними. Різниця в намірі: ви отримуєте дані, коли є причина, а не питаєте щохвилини на всякий випадок.
Поширені запитання
|
Чи буває polling кращим за webhooks для біометричних даних? Polling може бути простішим, коли ваша система взагалі не може відкрити жодної публічної кінцевої точки, або для разових історичних імпортів. Для поточних даних про відвідуваність і доступ webhooks швидші, менш навантажують пристрої та мережі й простіше масштабуються на кілька майданчиків. |
|
Що станеться зі сканами, якщо мій сервер webhook недоступний? Якщо ваш сервер webhook недоступний, дані про відвідуваність зберігаються в черзі Cams. Щойно ваш сервер знову стане доступним, записи з черги автоматично надішлються на ваш сервер. Черга автоматично перезапускається раз на 3 години, а також ви можете вручну перезапустити її в будь-який час через Cams Portal. Це гарантує, що записи відвідуваності не будуть втрачені через тимчасовий простій сервера. |
|
Чи потрібна біометричним пристроям публічна IP-адреса, щоб webhooks працювали? Ні. Ваш URL webhook має бути доступним для Gateway, але пристрої — ні. Майданчики без публічної IP-адреси можуть підключатися через Hybrid Connector, який використовує вихідне з'єднання. |
|
Чи можна отримувати webhooks у n8n, Make або Zapier? Так. Будь-який інструмент, який може отримувати вхідний webhook, може отримувати події Cams Callback. n8n і Make також можуть безпосередньо повертати необхідне підтвердження done. Zapier може потребувати невеликого проміжного relay, щоб надіслати цю відповідь. |
|
Чому LogTime і Time відрізняються в payload? LogTime — це час, коли людина фактично відсканувалася, записаний із урахуванням зсуву часового поясу пристрою. Time — це позначка часу самого повідомлення, у GMT. Якщо пристрій був офлайн, повідомлення може бути надіслано значно пізніше за скан. Для відвідуваності завжди використовуйте LogTime. |
Висновок: нехай дзвінок дзвонить
Polling мав сенс, коли біометричні пристрої можна було зчитувати лише на запит і ніхто не очікував, що дані про відвідуваність будуть актуальними. Сьогодні панелі HR, системи розрахунку зарплати, інструменти автоматизації та AI-асистенти найкраще працюють з даними в момент їх появи. Ставити пристрою одне й те саме питання тисячі разів на день — повільний і марнотратний спосіб це зробити.
Webhooks перетворюють кожен підтверджений скан на подію, яку ваші системи отримують одразу, без марних запитів і крихкого відстеження того, що вже було отримано. Залишайте отримання журналів на запит для того, у чому воно найкраще: заповнення прогалин і перевірка повноти, а решту нехай передають webhooks.
Cams Biometrics Gateway побудований навколо push-доставки. Його Callback API надсилає кожен підтверджений скан на ваш webhook у реальному часі з пристроїв понад 15 брендів в одному узгодженому форматі JSON. Режими Hybrid Push доставляють push-події навіть із пристроїв, які самостійно не можуть надсилати дані, а RESTful API надає операції на запит, наприклад завантаження журналів для звірки. Уся взаємодія відбувається через HTTP/HTTPS з перевіркою токена автентифікації та за бажанням із шифруванням AES-256. Ознайомтеся з платформою на CamsBiometrics.com і прочитайте повну документацію Callback API на developer.camsbiometrics.com.