Webhooks ou polling : comment les données biométriques en temps réel doivent parvenir à votre serveur
Toute intégration biométrique doit répondre à une question fondamentale : comment un pointage effectué à la porte devient-il un enregistrement dans votre système ? Il existe deux méthodes. Votre serveur peut interroger régulièrement l'appareil pour savoir si quelque chose de nouveau s'est produit, c'est le polling. Ou bien le système peut informer votre serveur au moment où l'événement se produit, c'est le webhook. Pour les données de présence et d'accès biométriques, le choix entre webhooks et polling influe sur la fraîcheur de vos données, sur la charge imposée aux appareils et aux réseaux, ainsi que sur la fiabilité de vos enregistrements. Ce guide explique les deux approches en termes simples, montre pourquoi les webhooks sont la meilleure option par défaut pour les données biométriques, décrit comment construire un récepteur de webhook fiable, et précise la place que le polling conserve encore.
01 · Pull ou Push
Deux façons de transmettre les données
Imaginez que vous attendez un colis important. Vous pourriez aller jusqu'à la porte d'entrée toutes les cinq minutes pour vérifier s'il est arrivé. Ou vous pourriez attendre que la sonnette retentisse. Dans les deux cas, vous recevez le colis. La première solution vous fait faire beaucoup de déplacements inutiles et vous fait tout de même arriver jusqu'à cinq minutes en retard. La seconde vous prévient dès l'arrivée du colis.
C'est la différence entre le polling et les webhooks.
Polling : votre serveur interroge en permanence
|
Votre serveur Demande : y a-t-il de nouveaux pointages depuis la dernière fois ? |
→ |
Appareil ou système Répond : rien de nouveau |
→ |
Attente Pause pendant l'intervalle de polling |
→ |
Répétition Demander encore, et encore, toute la journée |
Webhook : le système informe votre serveur
|
Pointage d'un employé Une empreinte digitale, un visage ou une carte vérifié(e) |
→ |
Gateway Envoie l'événement immédiatement à votre URL de webhook |
→ |
Votre serveur Reçoit l'événement et répond terminé |
→ |
Terminé Aucune attente et aucune requête inutile |
| Polling | Webhooks | |
|---|---|---|
| Qui initie l'échange | Votre serveur | Le système qui détient les données |
| Moment d'arrivée des données | Lors de la prochaine interrogation, avec un retard pouvant aller jusqu'à un intervalle complet | Immédiatement après le pointage |
| Requêtes lorsque rien ne se passe | Continues, dont la plupart sont vides | Aucune |
| Charge sur les appareils et le réseau | Constante, quelle que soit l'activité | Uniquement lorsqu'il y a quelque chose à envoyer |
| Complexité pour vous | Suivi de ce qui a déjà été récupéré | Réception et accusé de réception des événements |
02 · Les coûts cachés
Pourquoi le polling peine avec les données biométriques
Le polling convient aux données qui évoluent lentement ou pour lesquelles un délai n'a pas d'importance. Les données de présence et d'accès biométriques sont à l'opposé. Elles sont générées en rafales marquées au début et à la fin des équipes, restent calmes le reste du temps, et sont souvent nécessaires immédiatement.
Le délai est intrinsèque
Avec le polling, le délai au pire cas est toujours égal à votre intervalle de polling. Un pointage effectué une seconde après une interrogation attend l'intervalle complet avant que votre serveur ne le voie.
| Intervalle de polling | Délai au pire cas avant que votre système ne le sache | Suffisant pour |
|---|---|---|
| Toutes les 24 heures | Jusqu'à une journée complète | La paie mensuelle uniquement |
| Toutes les heures | Jusqu'à 60 minutes | Rapports quotidiens |
| Toutes les 5 minutes | Jusqu'à 5 minutes | La plupart des tableaux de bord, pas les alertes |
| Toutes les minutes | Jusqu'à 60 secondes | Quasi temps réel, à un coût élevé en requêtes |
| Webhook | Aucun délai d'interrogation | Tableaux de bord en direct, notifications et automatisations |
La plupart des requêtes sont inutiles
Pour se rapprocher du temps réel, il faut interroger plus souvent. Mais la plupart de ces requêtes ne renvoient rien. Interroger un appareil chaque minute représente 1 440 requêtes par appareil et par jour. Pour 50 appareils, cela fait 72 000 requêtes par jour, dont la plupart posent une question dont la réponse est « rien de nouveau ». Chacune de ces requêtes consomme de la capacité réseau et du temps de traitement sur l'appareil.
Le suivi devient fragile
Une intégration en polling doit se souvenir de ce qu'elle a déjà récupéré, généralement en stockant l'heure ou la position du dernier enregistrement vu. Si ce repère est erroné, à cause d'un redémarrage, d'un décalage d'horloge entre le serveur et l'appareil, ou d'enregistrements stockés pendant qu'un appareil était hors ligne, l'intégration manque des pointages ou les importe deux fois. Ces problèmes sont silencieux et n'apparaissent souvent qu'à l'occasion d'un litige sur la paie.
La difficulté augmente avec chaque site
Avec un seul appareil, le polling reste gérable. Avec des dizaines d'appareils répartis sur plusieurs sites et de plusieurs marques, chacun avec sa propre connexion, son propre intervalle et son propre repère de dernière récupération, le polling devient une tâche de planification et de supervision à part entière.
|
Le polling pose la même question des milliers de fois par jour pour saisir les quelques moments qui comptent. Les webhooks ne parlent que lorsque quelque chose s'est réellement produit. |
03 · Diffusion push avec Cams
Fonctionnement des webhooks biométriques
Avec Cams Biometrics Gateway, la diffusion par webhook s'appelle la Callback API. Vous indiquez à la Gateway une URL sur votre serveur, et chaque pointage vérifié est envoyé à cette URL au moment où il se produit. Les événements Callback sont diffusés sans latence pour les appareils en Native Push.
Ce que reçoit votre serveur
|
Callback API, requête envoyée à votre URL de webhook par la Gateway {
"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"
}
}
|
| Champ | Ce qu'il indique à votre serveur |
|---|---|
| OperationID | Une référence unique pour cet événement |
| LabelName | Le nom du site ou de la porte auquel l'appareil est affecté |
| SerialNumber | L'appareil précis qui a enregistré le pointage |
| Type | Il s'agit d'une arrivée ou d'un départ |
| InputType | Le mode de vérification de la personne : empreinte digitale, visage, carte, code PIN, etc. |
| UserId | La personne qui a pointé, correspondant à l'identifiant de votre système RH |
| LogTime | Le moment où le pointage a eu lieu sur l'appareil, avec son décalage horaire |
| AuthToken | Le jeton que votre serveur utilise pour confirmer que la requête est authentique |
| Time | L'horodatage du message lui-même, en GMT |
Ce que votre serveur doit renvoyer
Une fois l'événement reçu, votre serveur renvoie un bref accusé de réception. Cela indique à la Gateway que l'événement est bien arrivé.
|
Callback API, réponse que votre webhook doit renvoyer { "status": "done" }
|
|
Push, même lorsque l'appareil ne le peut pas Tous les appareils ne peuvent pas envoyer eux-mêmes leurs données. Certains appareils anciens ou non vérifiés ne font que stocker les présences dans une base de données ou un fichier locaux. Avec Cams Hybrid Push, la Gateway peut lire cette base de données (DB Pull) ou surveiller ce fichier (File Processing), et transmettre tout de même les nouveaux enregistrements de présence à votre Callback URL. Votre serveur bénéficie de la diffusion push dans les deux cas, même si l'appareil sous-jacent aurait normalement besoin d'être interrogé. |
04 · Bonnes pratiques
Construire un récepteur de webhook fiable
Un récepteur de webhook est simple à construire, mais quelques pratiques font la différence entre un outil qui fonctionne en test et un outil qui fonctionne chaque jour, pendant des années.
| Pratique | Que faire | Pourquoi c'est important |
|---|---|---|
| Accuser réception en premier | Renvoyer le statut done dès que l'événement est reçu, puis effectuer les traitements plus lents ensuite | Garde la requête de la Gateway courte, même si vos systèmes aval sont lents |
| Mettre le travail en file d'attente | Placer chaque événement reçu dans une file d'attente ou une table, puis le traiter séparément | Absorbe les rafales de début d'équipe sans perdre d'événements |
| Valider l'AuthToken | Vérifier le jeton dans chaque requête avant de faire confiance aux données | Empêche quiconque d'envoyer de faux pointages à votre URL |
| Utiliser HTTPS | N'exposer votre webhook que via HTTPS, avec un chiffrement AES-256 optionnel depuis la Gateway | Les données de présence sont des données personnelles et doivent être protégées pendant leur transmission |
| Rendre le traitement idempotent | Utiliser OperationID pour détecter et ignorer les événements déjà traités | Une livraison répétée ne crée jamais un doublon de présence |
| Se fier à LogTime pour la présence | Enregistrer la présence à l'aide de LogTime, et non de l'heure de réception de l'événement par votre serveur | Les événements stockés pendant une panne arrivent plus tard, mais conservent leur heure réelle de pointage |
| Trier par LogTime | Ordonner les événements par LogTime avant de calculer les heures | Les événements mis en mémoire tampon peuvent arriver dans le désordre après une coupure de connexion |
| Tout journaliser | Conserver une trace de chaque événement reçu et de chaque réponse envoyée | Facilite le dépannage et les audits |
|
Prévoir les rafales, pas les moyennes Un site de 300 employés peut ne recevoir presque rien pendant la majeure partie de la journée, puis 300 événements en dix minutes lors du changement d'équipe. Dimensionnez votre récepteur pour ce pic. Accuser réception rapidement et mettre le travail en file d'attente est la manière la plus simple de le gérer. |
Où peut se trouver le webhook
Votre webhook a besoin d'une adresse HTTPS publique que la Gateway peut atteindre. Il peut s'agir d'un point de terminaison dans votre propre application, d'une petite fonction cloud, ou d'un webhook entrant dans un outil d'automatisation tel que n8n ou Make. Vos appareils eux-mêmes n'ont pas besoin d'une adresse IP publique. Les sites protégés par des pare-feu peuvent se connecter à la Gateway via le Hybrid Connector, qui fonctionne grâce à une connexion sortante.
|
Votre système décide de la suite La Gateway diffuse les événements vérifiés et attend votre accusé de réception. Ce qui se passe ensuite, par exemple l'écriture dans votre SIRH, la mise à jour d'un tableau de bord, l'envoi d'une notification de retard ou le lancement d'un workflow, est décidé par vos propres logiciels et règles. |
05 · Utiliser les deux ensemble
Où le polling conserve sa place
Les webhooks doivent être l'option par défaut pour les données biométriques en direct. Mais la récupération de données à la demande conserve des usages utiles et précis. Les intégrations les plus solides utilisent les webhooks pour la diffusion en temps réel, et des récupérations ponctuelles à la demande pour la vérification et la reprise après incident.
| Situation | Meilleure approche | Pourquoi |
|---|---|---|
| Présence en direct, tableaux de bord, notifications | Webhooks (Callback API) | Les données arrivent au moment même du pointage |
| Votre serveur a été hors ligne pendant un certain temps | Récupérer les journaux à la demande | Combler toute lacune et confirmer qu'aucune donnée n'a été perdue |
| Réconciliation nocturne ou hebdomadaire | Récupérer les journaux selon un planning | Comparer avec ce que les webhooks ont livré, en filet de sécurité |
| Mise en place d'une nouvelle intégration | Récupérer les journaux historiques une seule fois | Importer l'historique existant avant que les webhooks ne prennent le relais |
| Audit d'une période donnée | Récupérer les journaux de cette période | Produire un enregistrement complet pour vérification |
Pour ces usages, la RESTful API de Cams comprend des opérations permettant de charger les journaux depuis les appareils. Utilisée de façon occasionnelle et délibérée, la récupération des journaux complète les webhooks au lieu de leur faire concurrence. La différence tient à l'intention : vous récupérez les données lorsque vous avez une raison de le faire, au lieu de demander toutes les minutes au cas où.
Questions fréquentes
|
Le polling est-il parfois préférable aux webhooks pour les données biométriques ? Le polling peut être plus simple lorsque votre système ne peut exposer aucun point de terminaison public, ou pour des imports historiques ponctuels. Pour les données de présence et d'accès en continu, les webhooks sont plus rapides, moins lourds pour les appareils et les réseaux, et plus faciles à déployer sur plusieurs sites. |
|
Que deviennent les pointages si mon serveur de webhook est hors service ? Si votre serveur de webhook est hors service, les données de présence sont stockées dans la file d'attente de Cams. Dès que votre serveur est de nouveau en ligne, les enregistrements en attente lui sont envoyés automatiquement. La file d'attente redémarre automatiquement toutes les 3 heures, et vous pouvez aussi la redémarrer manuellement à tout moment depuis le Cams Portal. Cela garantit que les enregistrements de présence ne sont pas perdus en cas d'indisponibilité temporaire du serveur. |
|
Mes appareils biométriques ont-ils besoin d'une IP publique pour que les webhooks fonctionnent ? Non. Votre URL de webhook doit être accessible par la Gateway, mais vos appareils, eux, ne le doivent pas. Les sites sans IP publique peuvent se connecter via le Hybrid Connector, qui utilise une connexion sortante. |
|
Puis-je recevoir des webhooks dans n8n, Make ou Zapier ? Oui. Tout outil capable de recevoir un webhook entrant peut recevoir les événements Callback de Cams. n8n et Make peuvent également renvoyer directement l'accusé de réception done requis. Zapier peut nécessiter un petit relais en amont pour envoyer cette réponse. |
|
Pourquoi LogTime et Time diffèrent-ils dans la charge utile ? LogTime correspond au moment où la personne a réellement pointé, enregistré avec le décalage horaire de l'appareil. Time est l'horodatage du message lui-même, en GMT. Si un appareil était hors ligne, le message peut être envoyé bien après le pointage. Utilisez toujours LogTime pour la présence. |
Conclusion : laissez sonner la sonnette
Le polling avait du sens lorsque les appareils biométriques ne pouvaient être lus que sur demande, et que personne n'attendait des données de présence en temps réel. Aujourd'hui, les tableaux de bord RH, les systèmes de paie, les outils d'automatisation et les assistants IA fonctionnent au mieux avec des données dès leur création. Poser la même question à un appareil des milliers de fois par jour est une façon lente et coûteuse d'y parvenir.
Les webhooks transforment chaque pointage vérifié en un événement que vos systèmes reçoivent immédiatement, sans requête inutile et sans suivi fragile de ce qui a déjà été récupéré. Réservez la récupération des journaux à la demande à ce qu'elle fait le mieux, combler les lacunes et vérifier l'exhaustivité, et laissez les webhooks transporter tout le reste.
Cams Biometrics Gateway est conçue autour de la diffusion push. Sa Callback API envoie chaque pointage vérifié à votre webhook en temps réel, depuis des appareils de plus de 15 marques, dans un format JSON unique et cohérent. Les modes Hybrid Push diffusent des événements push même depuis des appareils incapables de push par eux-mêmes, et la RESTful API fournit des opérations à la demande, comme le chargement des journaux pour la réconciliation. Toutes les communications passent par HTTP/HTTPS avec validation du jeton d'authentification et chiffrement AES-256 optionnel. Découvrez la plateforme sur CamsBiometrics.com et consultez la documentation complète de la Callback API sur developer.camsbiometrics.com.