Support Hub/API & Integrations/Webhooks versus polling: hoe realtime biometrische…
Translated from the English article and reviewed by a person. Read the English original
Developer

Webhooks versus polling: hoe realtime biometrische gegevens je server moeten bereiken

Webhooks versus polling: hoe realtime biometrische gegevens je server moeten bereiken

Elke biometrische integratie moet één basisvraag beantwoorden: hoe wordt een scan bij de deur een registratie in je systeem? Er zijn twee manieren om dat te doen. Je server kan het apparaat blijven vragen of er iets nieuws is gebeurd, dat is polling. Of het systeem kan je server op het moment dat er iets gebeurt laten weten, dat is een webhook. Voor biometrische aanwezigheids- en toegangsgegevens bepaalt de keuze tussen webhooks en polling hoe actueel je gegevens zijn, hoeveel belasting je op apparaten en netwerken legt, en hoe betrouwbaar je registraties zijn. Deze gids legt beide benaderingen in begrijpelijke taal uit, laat zien waarom webhooks de betere standaard zijn voor biometrische gegevens, behandelt hoe je een betrouwbare webhook-ontvanger bouwt, en legt uit waar polling nog steeds een plaats heeft.

01 · Pull versus Push

Twee manieren waarop gegevens kunnen reizen

Stel je voor dat je op een belangrijk pakketje wacht. Je kunt elke vijf minuten naar de voordeur lopen om te controleren of het is aangekomen. Of je kunt wachten tot de deurbel gaat. Beide manieren brengen je het pakketje. De eerste kost veel gangen en laat je toch tot vijf minuten te laat zijn. De tweede vertelt je het moment dat het aankomt.

Dat is het verschil tussen polling en webhooks.

Polling: je server blijft vragen

Je server

Vraagt: zijn er nieuwe scans sinds de vorige keer?

→

Apparaat of systeem

Antwoordt: niets nieuws

→

Wacht

Wacht het pollinginterval af

→

Herhaal

Vraag opnieuw, en opnieuw, de hele dag

Webhook: het systeem vertelt je server

Medewerkersscan

Een geverifieerde vingerafdruk-, gezichts- of kaartscan

→

Gateway

Stuurt de gebeurtenis direct naar je webhook-URL

→

Je server

Ontvangt de gebeurtenis en antwoordt gereed

→

Gereed

Geen wachttijd en geen verspilde verzoeken

Polling Webhooks
Wie begint het gesprek Je server Het systeem met de gegevens
Wanneer gegevens binnenkomen Bij de volgende poll, tot één volledig interval te laat Direct na de scan
Verzoeken wanneer er niets gebeurt Continu, de meeste leeg Geen
Belasting op apparaten en netwerk Constant, ongeacht de activiteit Alleen wanneer er iets te versturen is
Complexiteit voor jou Bijhouden wat je al hebt opgehaald Gebeurtenissen ontvangen en bevestigen

02 · De verborgen kosten

Waarom polling moeilijk is met biometrische gegevens

Polling werkt voor gegevens die langzaam veranderen of waarbij vertraging niet uitmaakt. Biometrische aanwezigheids- en toegangsgegevens zijn het tegenovergestelde. Ze ontstaan in korte pieken bij het begin en einde van diensten, zijn de rest van de tijd rustig, en worden vaak meteen nodig.

De vertraging zit ingebouwd

Bij polling is de vertraging in het slechtste geval altijd gelijk aan je pollinginterval. Een scan die één seconde na een poll plaatsvindt, wacht het volledige interval voordat je server hem ziet.

Pollinginterval Vertraging in het slechtste geval voordat je systeem het weet Voldoende voor
Elke 24 uur Tot een volle dag Alleen maandelijkse salarisadministratie
Elk uur Tot 60 minuten Dagelijkse rapporten
Elke 5 minuten Tot 5 minuten De meeste dashboards, niet voor meldingen
Elke minuut Tot 60 seconden Bijna realtime, tegen hoge verzoekkosten
Webhook Geen pollingvertraging Live dashboards, meldingen en automatiseringen

De meeste verzoeken zijn verspild

Om dichter bij realtime te komen, pol je vaker. Maar de meeste van die verzoeken leveren niets op. Eén apparaat elke minuut pollen betekent 1.440 verzoeken per apparaat per dag. Over 50 apparaten is dat 72.000 verzoeken per dag, de meeste met de vraag waarvan het antwoord “niets nieuws” is. Elk van die verzoeken gebruikt netwerkcapaciteit en verwerkingstijd van het apparaat.

Bijhouden wordt kwetsbaar

Een polling-integratie moet onthouden wat het al heeft opgehaald, meestal door het tijdstip of de positie van het laatst geziene record op te slaan. Als die markering verkeerd is, door een herstart, een klokverschil tussen server en apparaat, of records die zijn opgeslagen terwijl een apparaat offline was, dan mist de integratie scans of importeert ze dubbel. Deze problemen zijn stil en komen vaak pas naar boven bij een discussie over de salarisadministratie.

Het wordt moeilijker met elke vestiging

Met één apparaat is polling beheersbaar. Met tientallen apparaten verspreid over meerdere vestigingen en merken, elk met een eigen verbinding, eigen interval en eigen laatst-opgehaald-markering, wordt polling een eigen planning- en monitoringtaak.

Polling stelt dezelfde vraag duizenden keren per dag om de paar momenten die ertoe doen op te vangen. Webhooks spreken alleen wanneer er daadwerkelijk iets is gebeurd.

03 · Push-levering met Cams

Hoe biometrische webhooks werken

Met Cams Biometrics Gateway heet de webhook-levering de Callback API. Je geeft de Gateway een URL op je server, en elke geverifieerde scan wordt op het moment zelf naar die URL gestuurd. Callback-gebeurtenissen worden zonder vertraging geleverd voor apparaten op Native Push.

Wat je server ontvangt

Callback API, verzoek dat de Gateway naar je webhook-URL stuurt

{
  "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"
  }
}
Veld Wat het je server vertelt
OperationID Een unieke referentie voor deze gebeurtenis
LabelName De naam van de vestiging of deur waaraan het apparaat is toegewezen
SerialNumber Het specifieke apparaat dat de scan heeft vastgelegd
Type Of het een inchecken of uitchecken was
InputType Hoe de persoon zich heeft geverifieerd: vingerafdruk, gezicht, kaart, pincode, enzovoort
UserId Wie heeft gescand, overeenkomend met het ID in je HR-systeem
LogTime Wanneer de scan op het apparaat plaatsvond, met de tijdzoneverschuiving
AuthToken Het token waarmee je server bevestigt dat het verzoek echt is
Time Het tijdstempel van het bericht zelf, in GMT

Wat je server moet terugsturen

Zodra je server de gebeurtenis heeft ontvangen, antwoordt het met een korte bevestiging. Dit laat de Gateway weten dat de gebeurtenis veilig is aangekomen.

Callback API, antwoord dat je webhook moet terugsturen

{ "status": "done" }

Push, ook wanneer het apparaat dat niet kan

Niet elk apparaat kan zelfstandig gegevens pushen. Sommige oudere of niet-geverifieerde apparaten slaan aanwezigheid alleen op in een lokale database of bestand. Met Cams Hybrid Push kan de Gateway die database lezen (DB Pull) of dat bestand bewaken (File Processing), en nog steeds nieuwe aanwezigheidsregistraties naar je Callback-URL leveren. Je server krijgt in beide gevallen pushlevering, ook als het apparaat eronder normaal gepolld moet worden.

04 · Best practices

Een betrouwbare webhook-ontvanger bouwen

Een webhook-ontvanger is eenvoudig te bouwen, maar een paar praktijken maken het verschil tussen een die in tests werkt en een die jaren dagelijks werkt.

Praktijk Wat te doen Waarom het belangrijk is
Eerst bevestigen Antwoord met de done-status zodra de gebeurtenis is ontvangen, en doe het langzamere werk daarna Houdt het verzoek van de Gateway kort, ook als je downstream-systemen traag zijn
Werk in de wachtrij zetten Zet elke ontvangen gebeurtenis in een wachtrij of tabel, en verwerk deze afzonderlijk Verwerkt pieken bij het begin van de dienst zonder gebeurtenissen te verliezen
De AuthToken valideren Controleer het token in elk verzoek voordat je de gegevens vertrouwt Voorkomt dat anderen nep-aanwezigheid naar je URL posten
HTTPS gebruiken Stel je webhook alleen beschikbaar via HTTPS, met optionele AES-256-versleuteling vanuit de Gateway Aanwezigheidsgegevens zijn persoonsgegevens en moeten tijdens transport worden beschermd
Maak het idempotent Gebruik OperationID om gebeurtenissen die je al hebt verwerkt te herkennen en te negeren Een herhaalde levering wordt nooit een dubbele aanwezigheidsregistratie
Vertrouw LogTime voor aanwezigheid Registreer aanwezigheid met LogTime, niet het tijdstip waarop je server de gebeurtenis ontving Gebeurtenissen die tijdens een storing zijn opgeslagen komen later aan, maar behouden hun echte scantijd
Sorteer op LogTime Sorteer gebeurtenissen op LogTime voordat je uren berekent Gebufferde gebeurtenissen kunnen na een verbindingsonderbreking in de verkeerde volgorde aankomen
Log alles Houd een registratie bij van elke ontvangen gebeurtenis en elk verstuurd antwoord Maakt probleemoplossing en audits eenvoudig

Plan voor pieken, niet voor gemiddelden

Een vestiging met 300 medewerkers ontvangt misschien bijna niets gedurende de meeste van de dag, en daarna 300 gebeurtenissen in tien minuten bij het wisselen van dienst. Ontwerp je ontvanger voor die piek. Snel bevestigen en het werk in de wachtrij zetten is de eenvoudigste manier om dat aan te pakken.

Waar de webhook kan staan

Je webhook heeft een openbaar HTTPS-adres nodig dat de Gateway kan bereiken. Dat kan een eindpunt in je eigen applicatie zijn, een kleine cloudfunctie, of een inkomende webhook in een automatiseringstool zoals n8n of Make. Je apparaten zelf hebben geen openbaar IP-adres nodig. Vestigingen achter firewalls kunnen via de Hybrid Connector verbinding maken met de Gateway, die werkt via een uitgaande verbinding.

Je systeem bepaalt wat er daarna gebeurt

De Gateway levert geverifieerde gebeurtenissen en wacht op je bevestiging. Wat er daarna gebeurt, zoals wegschrijven naar je HRMS, een dashboard bijwerken, een melding voor te laat komen versturen of een workflow starten, wordt bepaald door je eigen software en regels.

05 · Beide samen gebruiken

Waar polling nog steeds een plaats heeft

Webhooks moeten de standaard zijn voor live biometrische gegevens. Maar het op aanvraag ophalen van gegevens heeft nog steeds nuttige, specifieke taken. De sterkste integraties gebruiken webhooks voor realtime levering en af en toe ophalen op aanvraag voor controle en herstel.

Situatie Beste aanpak Waarom
Live aanwezigheid, dashboards, meldingen Webhooks (Callback API) Gegevens komen binnen op het moment dat een scan plaatsvindt
Je server was een tijdje offline Logs op aanvraag ophalen Vult elke leemte op en bevestigt dat er niets is gemist
Nachtelijke of wekelijkse afstemming Logs volgens schema ophalen Vergelijken met wat webhooks hebben geleverd, als vangnet
Een nieuwe integratie opzetten Historische logs één keer ophalen Bestaande historie importeren voordat webhooks het overnemen
Een specifieke periode controleren Logs voor die periode ophalen Een volledige registratie opleveren voor beoordeling

Voor deze taken bevat de Cams RESTful API bewerkingen om logs van apparaten te laden. Wanneer dit af en toe en bewust gebeurt, vult het ophalen van logs webhooks aan in plaats van ermee te concurreren. Het verschil zit in de bedoeling: je haalt op wanneer je een reden hebt, in plaats van elke minuut te vragen voor het geval dat.

Veelgestelde vragen

Is polling ooit beter dan webhooks voor biometrische gegevens?

Polling kan eenvoudiger zijn wanneer je systeem helemaal geen openbaar eindpunt kan blootstellen, of voor eenmalige historische imports. Voor doorlopende aanwezigheids- en toegangsgegevens zijn webhooks sneller, lichter voor apparaten en netwerken, en makkelijker over vestigingen heen te schalen.

Wat gebeurt er met scans als mijn webhook-server offline is?

Als je webhook-server offline is, worden aanwezigheidsgegevens opgeslagen in de Cams-wachtrij. Zodra je server weer online is, worden de wachtende records automatisch naar je server gestuurd. De wachtrij herstart automatisch eens per 3 uur, en je kunt hem ook op elk moment handmatig herstarten vanuit het Cams Portal. Zo gaan aanwezigheidsregistraties niet verloren door tijdelijke serveruitval.

Hebben mijn biometrische apparaten een openbaar IP-adres nodig voor webhooks?

Nee. Je webhook-URL moet bereikbaar zijn voor de Gateway, maar je apparaten niet. Vestigingen zonder openbaar IP-adres kunnen verbinding maken via de Hybrid Connector, die een uitgaande verbinding gebruikt.

Kan ik webhooks ontvangen in n8n, Make of Zapier?

Ja. Elke tool die een inkomende webhook kan ontvangen, kan Cams Callback-gebeurtenissen ontvangen. n8n en Make kunnen de vereiste done-bevestiging ook direct terugsturen. Zapier heeft mogelijk een kleine relay ervoor nodig om dat antwoord te versturen.

Waarom verschillen LogTime en Time in de payload?

LogTime is het moment waarop de persoon daadwerkelijk heeft gescand, vastgelegd met de tijdzoneverschuiving van het apparaat. Time is het tijdstempel van het bericht zelf, in GMT. Als een apparaat offline was, kan het bericht lang na de scan worden verstuurd. Gebruik voor aanwezigheid altijd LogTime.

Conclusie: laat de deurbel maar gaan

Polling had zin toen biometrische apparaten alleen op verzoek konden worden uitgelezen en niemand verwachtte dat aanwezigheidsgegevens live waren. Vandaag werken HR-dashboards, salarisadministratiesystemen, automatiseringstools en AI-assistenten het best met gegevens op het moment dat ze ontstaan. Een apparaat duizenden keren per dag dezelfde vraag stellen is een trage, verspillende manier om daar te komen.

Webhooks maken van elke geverifieerde scan een gebeurtenis die je systemen direct ontvangen, zonder verspilde verzoeken en zonder kwetsbaar bijhouden van wat al is opgehaald. Gebruik het ophalen van logs op aanvraag voor wat het het beste doet, leemtes opvullen en volledigheid controleren, en laat webhooks al het andere dragen.

Cams Biometrics Gateway is gebouwd rond pushlevering. De Callback API stuurt elke geverifieerde scan in realtime naar je webhook, van apparaten van meer dan 15 merken, in één consistent JSON-formaat. Hybrid Push-modi leveren pushgebeurtenissen zelfs van apparaten die zelf niet kunnen pushen, en de RESTful API biedt bewerkingen op aanvraag, zoals het laden van logs voor afstemming. Alle communicatie verloopt via HTTP/HTTPS met validatie van het auth-token en optionele AES-256-versleuteling. Ontdek het platform op CamsBiometrics.com en lees de volledige Callback API-documentatie op developer.camsbiometrics.com.

Was this article helpful?