Accueil / Produits / API / Biometric Gateway Web API
API

Biometric Gateway Web API

La Biometric Gateway Web API (également connue sous le nom d'Universal Biometric Web API 3.0) transforme tout appareil à empreinte, visage, paume, veines, iris, rétine, carte ou mot de passe pris en charge en un endpoint connecté au cloud, avec lequel votre application peut dialoguer depuis n'importe où dans le monde. Recevez les pointages en temps réel à l'instant où ils se produisent et gérez à distance les utilisateurs sur l'appareil, le tout via un contrat simple REST plus Callback.

Présentation

Connectez directement à votre application web, via HTTP, tout appareil biométrique de pointage ou de contrôle d'accès relié à Internet — sans logiciel local, ni PC, ni base de données.

La Web API phare de Cams permet la communication de machine à serveur entre des appareils biométriques installés à distance et votre application serveur. Un appareil se connecte à Internet, la présence est envoyée en temps réel à votre URL de callback (webhook), et votre serveur pilote les opérations sur l'appareil — ajout ou suppression d'utilisateur, envoi de modèles, envoi de photos, chargement des journaux de pointage — par des appels RESTful. Inutile d'installer un logiciel de bureau, d'exploiter une base de données locale ou de maintenir un PC sur le LAN. L'API est indépendante de la base de données et fonctionne avec n'importe quel langage de backend.

APIRESTCallback/Webhook (HTTP POST)MQTT (chemin de connexion persistante EMQX)PHPPythonJavaNode.js
Callback (webhook) — pointage en temps réel
# Your Callback URL receives every punch in real time
POST https://yourapp.com/cams/callback
{
  "DeviceSN": "SN7A2300583",
  "EmployeeCode": "1042",
  "AttendanceLog": "2026-06-21 09:02:14",
  "Type": "face",
  "Direction": "CheckIn"
}

Fonctionnalités

Ce qu'il fait

Présence en temps réel

Les pointages sont envoyés à votre URL de callback à l'instant où ils sont enregistrés sur l'appareil.

Gestion des utilisateurs à distance

Ajoutez, supprimez, bloquez et déplacez des utilisateurs, et envoyez modèles ou photos aux appareils depuis votre serveur par des appels RESTful.

Capture multimodale

Un seul contrat gère les entrées d'empreinte, de visage, de paume, de veines, d'iris, de rétine, de carte et de mot de passe.

Résilience hors ligne

Les pointages hors ligne sont mis en mémoire tampon sur l'appareil et rejoués dans l'ordre dès le retour de la connectivité.

Transport chiffré

Le chiffrement AES-256 des données brutes peut être activé appareil par appareil pour sécuriser les échanges.

Caractéristiques

Tout est inclus

  • L'API Callback (webhook) achemine les pointages en temps réel de l'appareil à votre serveur, sans latence de polling
  • API RESTful pour les opérations du serveur vers l'appareil : Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog et plus (38 opérations)
  • Capture plusieurs types d'entrée par pointage : empreinte, visage, carte, paume, veines du doigt, iris, rétine, mot de passe, ainsi que des indicateurs de température corporelle et de port du masque lorsque le matériel le permet
  • Les types de pointage incluent CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
  • Gère les pointages hors ligne : les données en file d'attente sont transmises dans l'ordre à la reconnexion de l'appareil
  • Chiffrement AES-256 optionnel de toutes les données brutes échangées, avec une clé de sécurité définie dans l'API Monitor
  • L'API LoadLog permet aux applications non serveur et limitées au LAN de récupérer à la demande jusqu'à 30 jours d'historique de présence
  • Codes d'état documentés pour une gestion d'erreurs robuste, avec AuthToken par appareil et traçage OperationID pour le support et le rapprochement

Développez avec Biometric Gateway Web API

Obtenez une clé, lisez la documentation et livrez. Notre équipe vous accompagne pour votre première intégration.

FAQ

Questions fréquentes

Dois-je installer un logiciel sur mon réseau local pour utiliser la Web API ?

Non. La communication se fait en HTTP entre l'appareil et votre serveur. Tant que l'appareil est connecté à Internet, vous pouvez recevoir la présence et gérer les utilisateurs sans logiciel local, base de données ni PC.

Quelles entrées biométriques la Web API prend-elle en charge ?

Empreinte, visage, carte, paume, veines du doigt, iris, rétine et mot de passe, ainsi que les données de température corporelle et de port du masque lorsque le matériel les fournit.

Quelle est la différence entre l'API Callback et l'API RESTful ?

L'API Callback est une communication temps réel de l'appareil vers le serveur, via une URL que vous exposez sur votre serveur (sans latence). L'API RESTful est une communication du serveur vers l'appareil, que vous appelez sur l'endpoint de Cams pour gérer l'appareil, avec une latence pouvant atteindre environ 15 secondes.

Puis-je utiliser l'API si mon serveur n'a pas d'IP publique ?

Oui. Utilisez l'API LoadLog pour récupérer à la demande les journaux de présence d'une période donnée, tant que l'appareil est connecté à Internet.

Voir aussi

Explorez le reste de la plateforme