Webhook-uri vs polling: cum ar trebui datele biometrice în timp real să ajungă la serverul dumneavoastră
Orice integrare biometrică trebuie să răspundă la o întrebare de bază: cum ajunge o scanare de la intrare să devină o înregistrare în sistemul dumneavoastră? Există două modalități. Serverul dumneavoastră poate întreba periodic dispozitivul dacă a avut loc ceva nou, ceea ce reprezintă polling. Sau sistemul poate anunța serverul dumneavoastră în momentul în care se întâmplă ceva, ceea ce reprezintă un webhook. Pentru datele de prezență și acces biometric, alegerea între webhook-uri și polling influențează cât de actuale sunt datele, cât de mare este sarcina pusă pe dispozitive și rețele și cât de fiabile sunt înregistrările. Acest ghid explică ambele abordări în termeni simpli, arată de ce webhook-urile sunt opțiunea implicită mai bună pentru datele biometrice, prezintă modul de construire a unui receptor de webhook fiabil și explică unde mai are rost polling-ul.
01 · Pull vs Push
Două moduri în care datele pot circula
Imaginați-vă că așteptați un colet important. Puteți merge la ușa din față la fiecare cinci minute pentru a verifica dacă a sosit. Sau puteți aștepta să sune soneria. Ambele variante vă aduc coletul. Prima presupune multe deplasări inutile și vă lasă totuși cu o întârziere de până la cinci minute. A doua vă anunță în momentul în care coletul ajunge.
Aceasta este diferența dintre polling și webhook-uri.
Polling: serverul dumneavoastră tot întreabă
|
Serverul dumneavoastră Întreabă: există scanări noi de la ultima dată? |
→ |
Dispozitiv sau sistem Răspunde: nimic nou |
→ |
Așteptare Pauză pentru intervalul de polling |
→ |
Repetare Întreabă din nou, și din nou, toată ziua |
Webhook: sistemul îi spune serverului dumneavoastră
|
Scanare angajat O verificare cu amprentă, față sau card |
→ |
Gateway Trimite evenimentul imediat la URL-ul webhook |
→ |
Serverul dumneavoastră Primește evenimentul și răspunde done |
→ |
Done Fără așteptare și fără cereri inutile |
| Polling | Webhook-uri | |
|---|---|---|
| Cine începe conversația | Serverul dumneavoastră | Sistemul care deține datele |
| Când ajung datele | La următoarea interogare, cu până la un interval complet de întârziere | Imediat după scanare |
| Cereri când nu se întâmplă nimic | Continue, majoritatea goale | Niciuna |
| Sarcina asupra dispozitivelor și rețelei | Constantă, indiferent de activitate | Doar când există ceva de trimis |
| Complexitate pentru dumneavoastră | Urmărirea a ceea ce ați preluat deja | Primirea și confirmarea evenimentelor |
02 · Costurile ascunse
De ce polling-ul se confruntă cu dificultăți în cazul datelor biometrice
Polling-ul funcționează pentru datele care se schimbă lent sau unde o întârziere nu contează. Datele de prezență și acces biometric sunt opusul acestui caz. Ele sunt generate în rafale intense la începutul și la sfârșitul turelor, sunt liniștite cea mai mare parte a timpului și sunt adesea necesare imediat.
Întârzierea este inclusă în mecanism
În cazul polling-ului, întârzierea în cel mai defavorabil caz este întotdeauna egală cu intervalul de polling. O scanare care are loc la o secundă după o interogare așteaptă întregul interval până când serverul dumneavoastră o vede.
| Interval de polling | Întârziere maximă până când sistemul dumneavoastră află | Suficient pentru |
|---|---|---|
| La fiecare 24 de ore | Până la o zi întreagă | Doar statele de plată lunare |
| În fiecare oră | Până la 60 de minute | Rapoarte zilnice |
| La fiecare 5 minute | Până la 5 minute | Majoritatea tablourilor de bord, nu alerte |
| În fiecare minut | Până la 60 de secunde | Aproape în timp real, cu un cost ridicat al cererilor |
| Webhook | Fără întârziere de polling | Tablouri de bord live, notificări și automatizări |
Cele mai multe cereri sunt inutile
Pentru a te apropia de timpul real, interogați mai des. Dar majoritatea acestor cereri nu returnează nimic. Interogarea unui dispozitiv în fiecare minut înseamnă 1.440 de cereri pe dispozitiv pe zi. Pentru 50 de dispozitive, rezultă 72.000 de cereri pe zi, majoritatea punând o întrebare al cărei răspuns este „nimic nou”. Fiecare dintre aceste cereri consumă capacitatea rețelei și timpul de procesare al dispozitivului.
Urmărirea devine fragilă
O integrare prin polling trebuie să rețină ce a preluat deja, de obicei stocând momentul sau poziția ultimei înregistrări văzute. Dacă acest marcaj este greșit, din cauza unei reporniri, a unei diferențe de ceas între server și dispozitiv sau a unor înregistrări stocate în timp ce dispozitivul era offline, integrarea fie pierde scanări, fie le importă de două ori. Aceste probleme sunt discrete și adesea ies la suprafață doar în timpul unei dispute legate de salarizare.
Devine mai dificil cu fiecare sediu
Cu un singur dispozitiv, polling-ul este gestionabil. Cu zeci de dispozitive din mai multe sedii și de la mai multe mărci, fiecare cu propria conexiune, propriul interval și propriul marcaj al ultimei preluări, polling-ul devine o sarcină separată de programare și monitorizare.
|
Polling-ul pune aceeași întrebare de mii de ori pe zi pentru a prinde câteva momente care contează. Webhook-urile vorbesc doar atunci când ceva s-a întâmplat cu adevărat. |
03 · Livrare push cu Cams
Cum funcționează webhook-urile biometrice
Cu Cams Biometrics Gateway, livrarea prin webhook se numește Callback API. Oferiți Gateway-ului un URL de pe serverul dumneavoastră, iar fiecare scanare verificată este trimisă la acel URL pe măsură ce se produce. Evenimentele de callback sunt livrate fără latență pentru dispozitivele de pe Native Push.
Ce primește serverul dumneavoastră
|
Callback API, cerere trimisă de Gateway la URL-ul 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"
}
}
|
| Câmp | Ce îi transmite serverului dumneavoastră |
|---|---|
| OperationID | O referință unică pentru acest eveniment |
| LabelName | Numele sediului sau al ușii căreia îi este atribuit dispozitivul |
| SerialNumber | Dispozitivul specific care a înregistrat scanarea |
| Type | Dacă a fost o intrare sau o ieșire |
| InputType | Modul de verificare al persoanei: amprentă, față, card, PIN și altele |
| UserId | Cine a scanat, corespunzător ID-ului din sistemul dumneavoastră HR |
| LogTime | Când a avut loc scanarea pe dispozitiv, cu decalajul fusului orar |
| AuthToken | Tokenul pe care serverul dumneavoastră îl folosește pentru a confirma că cererea este autentică |
| Time | Marcajul de timp al mesajului în sine, în GMT |
Ce trebuie să trimită înapoi serverul dumneavoastră
Odată ce serverul dumneavoastră a primit evenimentul, răspunde cu o scurtă confirmare. Aceasta îi indică Gateway-ului că evenimentul a ajuns în siguranță.
|
Callback API, răspunsul pe care webhook-ul dumneavoastră trebuie să îl returneze { "status": "done" }
|
|
Push, chiar și când dispozitivul nu poate Nu orice dispozitiv poate trimite date singur. Unele dispozitive mai vechi sau neverificate stochează prezența doar într-o bază de date locală sau într-un fișier. Cu Cams Hybrid Push, Gateway-ul poate citi din acea bază de date (DB Pull) sau poate monitoriza acel fișier (File Processing) și poate livra în continuare înregistrările noi de prezență la URL-ul dumneavoastră de callback. Serverul dumneavoastră primește livrare push în ambele cazuri, chiar dacă dispozitivul de bază ar necesita în mod normal interogare. |
04 · Bune practici
Construirea unui receptor de webhook fiabil
Un receptor de webhook este simplu de construit, dar câteva practici fac diferența între unul care funcționează în testare și unul care funcționează zi de zi, ani la rând.
| Practică | Ce trebuie făcut | De ce contează |
|---|---|---|
| Confirmați primul | Răspundeți cu statusul done imediat ce evenimentul este primit, apoi efectuați lucrările mai lente ulterior | Menține cererea Gateway-ului scurtă, chiar dacă sistemele dumneavoastră din aval sunt lente |
| Puneți lucrul în coadă | Plasați fiecare eveniment primit într-o coadă sau într-un tabel și procesați-l separat | Gestionează rafalele de la începutul turei fără a pierde evenimente |
| Validați AuthToken | Verificați tokenul din fiecare cerere înainte de a avea încredere în date | Împiedică pe oricine altcineva să trimită prezențe false la URL-ul dumneavoastră |
| Folosiți HTTPS | Expuneți webhook-ul doar prin HTTPS, cu criptare AES-256 opțională din Gateway | Datele de prezență sunt date cu caracter personal și trebuie protejate în timpul transmiterii |
| Asigurați idempotența | Folosiți OperationID pentru a detecta și ignora evenimentele pe care le-ați procesat deja | O livrare repetată nu devine niciodată o înregistrare de prezență duplicată |
| Bazați-vă pe LogTime pentru prezență | Înregistrați prezența folosind LogTime, nu ora la care serverul dumneavoastră a primit evenimentul | Evenimentele stocate în timpul unei pene ajung mai târziu, dar își păstrează ora reală a scanării |
| Sortați după LogTime | Ordonați evenimentele după LogTime înainte de a calcula orele | Evenimentele memorate în tampon pot sosi în dezordine după o întrerupere a conexiunii |
| Înregistrați totul | Păstrați o evidență a fiecărui eveniment primit și a fiecărui răspuns trimis | Face depanarea și auditurile simple |
|
Planificați pentru rafale, nu pentru medii Un sediu cu 300 de angajați poate primi aproape nimic cea mai mare parte a zilei, apoi 300 de evenimente în zece minute la schimbul de tură. Proiectați receptorul pentru acest vârf. Confirmarea rapidă și punerea lucrului în coadă reprezintă cea mai simplă metodă de a-l gestiona. |
Unde poate fi găzduit webhook-ul
Webhook-ul dumneavoastră are nevoie de o adresă HTTPS publică, accesibilă de către Gateway. Aceasta poate fi un endpoint din propria aplicație, o funcție mică în cloud sau un webhook de intrare dintr-un instrument de automatizare precum n8n sau Make. Dispozitivele dumneavoastră nu au nevoie în sine de un IP public. Sediile din spatele firewall-urilor se pot conecta la Gateway prin Hybrid Connector, care funcționează printr-o conexiune de ieșire.
|
Sistemul dumneavoastră decide ce urmează Gateway-ul livrează evenimentele verificate și așteaptă confirmarea dumneavoastră. Ce se întâmplă după aceea, cum ar fi scrierea în HRMS-ul dumneavoastră, actualizarea unui tablou de bord, trimiterea unei notificări de întârziere sau pornirea unui flux de lucru, este decis de propriul software și de regulile dumneavoastră. |
05 · Folosirea ambelor metode
Unde mai are rost polling-ul
Webhook-urile ar trebui să fie opțiunea implicită pentru datele biometrice în timp real. Dar preluarea datelor la cerere are în continuare sarcini utile și specifice. Cele mai solide integrări folosesc webhook-urile pentru livrarea în timp real și preluări ocazionale la cerere pentru verificare și recuperare.
| Situație | Abordarea recomandată | De ce |
|---|---|---|
| Prezență live, tablouri de bord, notificări | Webhook-uri (Callback API) | Datele sosesc în momentul în care are loc scanarea |
| Serverul dumneavoastră a fost offline o perioadă | Preluați jurnalele la cerere | Completează orice lacună și confirmă că nu s-a pierdut nimic |
| Reconciliere nocturnă sau săptămânală | Preluați jurnalele după un program | Comparați cu ceea ce au livrat webhook-urile, ca plasă de siguranță |
| Configurarea unei noi integrări | Preluați jurnalele istorice o singură dată | Importați istoricul existent înainte ca webhook-urile să preia controlul |
| Auditarea unei perioade specifice | Preluați jurnalele pentru perioada respectivă | Produce o evidență completă pentru verificare |
Pentru aceste sarcini, Cams RESTful API include operațiuni pentru încărcarea jurnalelor de pe dispozitive. Utilizată ocazional și cu scop, preluarea jurnalelor completează webhook-urile, în loc să concureze cu ele. Diferența este intenția: preluați atunci când aveți un motiv, în loc să întrebați în fiecare minut doar pentru orice eventualitate.
Întrebări frecvente
|
Există situații în care polling-ul este mai bun decât webhook-urile pentru datele biometrice? Polling-ul poate fi mai simplu atunci când sistemul dumneavoastră nu poate expune deloc un endpoint public sau pentru importuri istorice unice. Pentru datele continue de prezență și acces, webhook-urile sunt mai rapide, mai ușoare pentru dispozitive și rețele și mai ușor de extins pe mai multe sedii. |
|
Ce se întâmplă cu scanările dacă serverul meu de webhook este oprit? Dacă serverul dumneavoastră de webhook este oprit, datele de prezență vor fi stocate în coada Cams. Odată ce serverul dumneavoastră revine online, înregistrările din coadă vor fi trimise automat către serverul dumneavoastră. Coada se repornește automat o dată la 3 ore, iar dumneavoastră o puteți reporni manual oricând din Cams Portal. Acest mecanism asigură că înregistrările de prezență nu se pierd din cauza unei indisponibilități temporare a serverului. |
|
Dispozitivele biometrice au nevoie de un IP public pentru ca webhook-urile să funcționeze? Nu. URL-ul dumneavoastră webhook trebuie să fie accesibil de către Gateway, dar dispozitivele nu. Sediile fără IP public se pot conecta prin Hybrid Connector, care folosește o conexiune de ieșire. |
|
Pot primi webhook-uri în n8n, Make sau Zapier? Da. Orice instrument care poate primi un webhook de intrare poate primi evenimente Cams Callback. n8n și Make pot returna și confirmarea done necesară direct. Zapier ar putea avea nevoie de un releu mic în fața sa pentru a trimite acel răspuns. |
|
De ce diferă LogTime și Time în payload? LogTime este momentul în care persoana a scanat efectiv, înregistrat cu decalajul fusului orar al dispozitivului. Time este marcajul de timp al mesajului în sine, în GMT. Dacă un dispozitiv a fost offline, mesajul poate fi trimis cu mult după scanare. Folosiți întotdeauna LogTime pentru prezență. |
Concluzie: lăsați soneria să sune
Polling-ul a avut sens când dispozitivele biometrice puteau fi citite doar la cerere, iar nimeni nu se aștepta ca datele de prezență să fie live. Astăzi, tablourile de bord HR, sistemele de salarizare, instrumentele de automatizare și asistenții AI funcționează cel mai bine cu date din momentul în care există. A întreba un dispozitiv aceeași întrebare de mii de ori pe zi este o modalitate lentă și ineficientă de a ajunge acolo.
Webhook-urile transformă fiecare scanare verificată într-un eveniment pe care sistemele dumneavoastră îl primesc imediat, fără cereri inutile și fără urmărirea fragilă a ceea ce a fost deja preluat. Păstrați preluarea jurnalelor la cerere pentru ceea ce face cel mai bine, adică umplerea lacunelor și verificarea completitudinii, și lăsați webhook-urile să transporte tot restul.
Cams Biometrics Gateway este construit în jurul livrării push. Callback API al acestuia trimite fiecare scanare verificată la webhook-ul dumneavoastră în timp real, de la dispozitive din peste 15 mărci, într-un format JSON unitar. Modurile Hybrid Push livrează evenimente push chiar și de la dispozitive care nu pot trimite date singure, iar RESTful API oferă operațiuni la cerere, cum ar fi încărcarea jurnalelor pentru reconciliere. Toată comunicarea se desfășoară prin HTTP/HTTPS, cu validarea tokenului de autentificare și criptare AES-256 opțională. Explorați platforma la CamsBiometrics.com și citiți documentația completă a Callback API la developer.camsbiometrics.com.