Support Hub/API & Integrations/Webhook-uri vs polling: cum ar trebui datele biometrice în…
Translated from the English article and reviewed by a person. Read the English original
Developer

Webhook-uri vs polling: cum ar trebui datele biometrice în timp real să ajungă la serverul dumneavoastră

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.

Was this article helpful?