Introductie
Cams Biometric Gateway — Web API 3.0
De Cams Biometric Gateway is de universele Biometric API die elk biometrisch aanwezigheids- of toegangscontroleapparaat koppelt aan uw applicatie — ERP, HRMS, salarisverwerking, schoolbeheer, maatwerksoftware of AI-/automatiseringsworkflow. Het ondersteunt alle grote apparaatmerken en biedt, ongeacht de hardware, een gestandaardiseerde JSON-over-HTTP Biometric API.
38 bewerkingen — 11 Callback-API's (Apparaat → Server) en 27 RESTful API's (Server → Apparaat). Alle payloads zijn onbewerkte JSON via HTTP/HTTPS.
Alle biometrische apparaten worden ondersteund. Cams-apparaten, geverifieerde apparaten en merken van derden (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC en meer). Kies de
verbindingsmodus die bij uw situatie past.
Hoe het werkt
De Biometric Gateway bestaat uit:
Gateway-serverCloudplatform met de Cams Protocol Engine (protocolvertaling, datanormalisatie, offline caching, authenticatie) en de laag van de gestandaardiseerde API, die uw applicatie een consistente interface biedt.
Protocol EngineDe kernengine binnen de Gateway-server die met de biometrische apparaten communiceert, leverancierspecifieke protocollen vertaalt en zorgt voor veilige logging van datatransacties en identiteitsbeheer.
Protocol Engine LiteEen on-premise versie die u op uw eigen server (Windows/Linux) kunt installeren voor omgevingen met alleen LAN of voor zelfhosting. Dezelfde API, lokaal geïmplementeerd.
Integreert met
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Maatwerk-webapps
Uw applicatie
ERP
HRMS
Payroll
School-ERP
AI-workflow (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Maatwerkapps
Protocol Engine
Veilige authenticatieverwerking
Logging van datatransacties
Protocolvertaling
Offline cache & wachtrij
AES-256-versleuteling · Validatie van auth-token
Gestandaardiseerde API-laag
Identiteitsbeheer
AI-/MCP-integratie
Callback-dispatcher
REST-opdrachtrouter
Datanormalisatie · Protocolondersteuning voor meerdere merken
Vingerafdruk
·
Gezichtsherkenning
·
Handpalmaderen
·
RFID-kaart
·
PIN
·
QR / barcode
·
GPS-tracking
Biometrische apparaten — alle merken worden ondersteund
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ vele andere
| API-type | Richting | Latentie | Toepassing |
|---|
| Callback-API | Apparaat → Uw server | Realtime / geen vertraging | Aanwezigheidsregistraties en gebruikerssynchronisatie-events ontvangen |
| RESTful API | Uw server → Apparaat | ~15 seconden | Gebruikers toevoegen/verwijderen, logs laden, biometrie inschrijven |
Introductie
Aan de slag
Integreer in drie stappen. Uw server heeft een openbaar bereikbare URL nodig om callbacks te ontvangen.
1
Uw Callback-URL configureren
Log in op het API Monitor-portaal. Stel de openbare HTTPS-URL van uw server in als Callback-URL voor uw apparaat of apparaten. De API-engine stuurt biometrische events realtime per POST naar dit endpoint.
2
Aanwezigheidsregistraties ontvangen
Uw endpoint ontvangt een POST met een onbewerkte JSON-body — voor Callback-API's zijn geen queryparameters nodig. Valideer de AuthToken, verwerk de registratiegegevens en antwoord met {"status":"done"}.
3
RESTful API's aanroepen om gebruikers & apparaten te beheren
Stuur een JSON-opdracht per POST naar de RESTful endpoint-URL in uw API Monitor-account, met uw stgid (Service Tag ID) als queryparameter. De engine zet de opdracht in de wachtrij en het apparaat bevestigt deze binnen ~15 seconden.
Endpointformaat
| API-type | Methode | Hoe te versturen |
|---|
| Callback-API (inkomend) |
POST |
Het apparaat post naar uw geconfigureerde URL. Onbewerkte JSON-body; geen parameters. |
| RESTful API (uitgaand) |
POST |
U post naar de RESTful endpoint-URL (te vinden in uw API Monitor-account) met ?stgid=YOUR_SERVICE_TAG_ID en een onbewerkte JSON-body. |
Beantwoord Callback-verzoeken altijd onmiddellijk. Uw server moet {"status":"done"} (HTTP 200) teruggeven om de ontvangst te bevestigen. Voer vóór het antwoord geen zware verwerking uit — zet die in een wachtrij.
Documentatie
API-documentatie
De referentie is opgedeeld per onderwerp. Begin met de apparaatcompatibiliteit en ga daarna naar de callback- en REST-bewerkingen.
Ondersteunde apparaten en verbindingsmodiWelke apparaten de Gateway ondersteunt, hoe elk apparaat verbinding maakt (Native Push of Hybrid Push) en welke API-bewerkingen in elke modus beschikbaar zijn.
API-referentie: architectuur, velden en statuscodesDe bouwstenen die alle bewerkingen delen: aanvraagstroom, algemene JSON-velden, templatetypen, statuscodes, poorten en payloadversleuteling.
Callback-API's: realtime events van het apparaat naar uw serverElk event dat een apparaat naar uw callback-URL stuurt, met de JSON die uw server ontvangt en het antwoord dat deze moet teruggeven.
RESTful API's: opdrachten van uw server naar het apparaatOpdrachten die uw server via de Gateway naar een apparaat stuurt, met request- en response-JSON voor elk ervan.
De API lokaal testenHoe u apparaatcallbacks op een ontwikkelmachine ontvangt en REST-opdrachten met Postman test voordat u live gaat.
PHP-voorbeeld: biometrische aanwezigheid opslaan in MySQLEen werkende PHP-callbackhandler die aanwezigheidsregistraties in drie stappen opslaat in MySQL.
Prompts voor AI-codegeneratorenKopieer een prompt naar uw AI-assistent om integratiecode voor uw eigen stack te genereren.
FAQ, SDK en kostenVeelgestelde vragen van integrators, plus uitleg over hoe de SDK en de API-prijzen werken.
