Introduction
Cams Biometric Gateway — Web API 3.0
La Cams Biometric Gateway est l’API biométrique universelle qui connecte n’importe quel terminal biométrique de pointage ou de contrôle d’accès à votre application — ERP, SIRH, paie, gestion scolaire, logiciel sur mesure ou workflow d’IA/automatisation. Elle prend en charge toutes les grandes marques de terminaux et fournit une API biométrique JSON sur HTTP standardisée, quel que soit le matériel.
38 opérations — 11 API de callback (Terminal → Serveur) et 27 API RESTful (Serveur → Terminal). Tous les payloads sont du JSON brut sur HTTP/HTTPS.
Tous les terminaux biométriques sont pris en charge. Terminaux Cams, appareils vérifiés et marques tierces (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC, et bien d’autres). Choisissez le
mode de connexion adapté à votre installation.
Fonctionnement
La Biometric Gateway se compose de :
Serveur GatewayPlateforme hébergée dans le cloud qui comprend le Cams Protocol Engine (traduction de protocoles, normalisation des données, mise en cache hors ligne, authentification) et la couche d’API standardisée qui offre une interface cohérente à votre application.
Protocol EngineLe moteur central du serveur Gateway : il communique avec les terminaux biométriques, traduit les protocoles propres à chaque fabricant et gère la journalisation sécurisée des transactions de données ainsi que la gestion des identités.
Protocol Engine LiteVersion sur site installable sur votre propre serveur (Windows/Linux) pour les environnements LAN uniquement ou auto-hébergés. Même API, déployée en local.
S’intègre avec
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Applications web sur mesure
Votre application
ERP
SIRH
Paie
ERP scolaire
Workflow IA (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Applications sur mesure
Protocol Engine
Traitement d’authentification sécurisé
Journalisation des transactions de données
Traduction de protocoles
Cache hors ligne & file d’attente
Chiffrement AES-256 · Validation du jeton d’authentification
Couche d’API standardisée
Gestion des identités
Intégration IA / MCP
Répartiteur de callbacks
Routeur de commandes REST
Normalisation des données · Prise en charge multi-marques
Empreinte digitale
·
Reconnaissance faciale
·
Veines de la paume
·
Carte RFID
·
Code PIN
·
QR / Code-barres
·
Suivi GPS
Terminaux biométriques — Toutes les marques prises en charge
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ Beaucoup d’autres
| Type d’API | Sens | Latence | Cas d’usage |
|---|
| API de callback | Terminal → Votre serveur | Temps réel / latence nulle | Recevoir les pointages et les événements de synchronisation des utilisateurs |
| API RESTful | Votre serveur → Terminal | ~15 secondes | Ajouter/supprimer des utilisateurs, charger les journaux, enrôler des données biométriques |
Introduction
Prise en main
Intégrez en trois étapes. Votre serveur doit disposer d’une URL accessible publiquement pour recevoir les callbacks.
1
Configurez votre URL de callback
Connectez-vous au portail API Monitor. Définissez l’URL HTTPS publique de votre serveur comme URL de callback pour votre ou vos terminaux. Le moteur d’API enverra (POST) les événements biométriques à ce point de terminaison en temps réel.
2
Recevez les pointages
Votre point de terminaison reçoit une requête POST avec un corps JSON brut — aucun paramètre de requête n’est nécessaire pour les API de callback. Validez l’AuthToken, analysez les données de pointage et répondez avec {"status":"done"}.
3
Appelez les API RESTful pour gérer utilisateurs & terminaux
Envoyez (POST) une commande JSON à l’URL du point de terminaison RESTful fournie dans votre compte API Monitor, avec votre stgid (Service Tag ID) en paramètre de requête. Le moteur met la commande en file d’attente et le terminal l’acquitte sous ~15 secondes.
Format du point de terminaison
| Type d’API | Méthode | Mode d’envoi |
|---|
| API de callback (entrante) |
POST |
Le terminal envoie (POST) vers votre URL configurée. Corps JSON brut ; aucun paramètre. |
| API RESTful (sortante) |
POST |
Vous envoyez (POST) vers l’URL du point de terminaison RESTful (disponible dans votre compte API Monitor) avec ?stgid=YOUR_SERVICE_TAG_ID et un corps JSON brut. |
Répondez toujours immédiatement aux requêtes de callback. Votre serveur doit renvoyer {"status":"done"} (HTTP 200) pour accuser réception. N’effectuez pas de traitement lourd avant de répondre — mettez-le en file d’attente.
Documentation
Documentation de l’API
La référence est découpée par thème. Commencez par la compatibilité des terminaux, puis les opérations de callback et REST.
Terminaux pris en charge et modes de connexionQuels terminaux la Gateway prend en charge, comment chacun se connecte (Native Push ou Hybrid Push) et quelles opérations d’API sont disponibles dans chaque mode.
Référence de l’API : architecture, champs et codes de statutLes éléments communs à toutes les opérations : flux des requêtes, champs JSON communs, types de modèles, codes de statut, ports et chiffrement des payloads.
API de callback : événements en temps réel du terminal vers votre serveurTous les événements qu’un terminal envoie à votre URL de callback, avec le JSON reçu par votre serveur et la réponse qu’il doit renvoyer.
API RESTful : commandes de votre serveur vers le terminalLes commandes que votre serveur envoie à un terminal via la Gateway, avec le JSON de requête et de réponse pour chacune.
Tester l’API en localComment recevoir les callbacks des terminaux sur une machine de développement et tester les commandes REST avec Postman avant le déploiement.
Exemple PHP : stocker les présences biométriques dans MySQLUn gestionnaire de callback PHP fonctionnel qui enregistre les pointages dans MySQL, en trois étapes.
Prompts de génération de code par IACopiez un prompt dans votre assistant IA pour générer le code d’intégration adapté à votre propre stack.
FAQ, SDK et coûtLes questions fréquentes des intégrateurs, ainsi que le fonctionnement du SDK et de la tarification de l’API.
