Cams Biometric Gateway — Web API 3.0
Das Cams Biometric Gateway ist die universelle Biometric API, die jedes biometrische Zeiterfassungs- oder Zutrittskontrollgerät mit Ihrer Anwendung verbindet — ERP, HRMS, Lohnabrechnung, Schulverwaltung, Individualsoftware oder KI-/Automatisierungs-Workflow. Es unterstützt alle gängigen Gerätemarken und bietet unabhängig von der Hardware eine standardisierte Biometric API auf Basis von JSON über HTTP.
So funktioniert es
Das Biometric Gateway besteht aus:
Integriert mit
| API-Typ | Richtung | Latenz | Anwendungsfall |
|---|---|---|---|
| Callback-API | Gerät → Ihr Server | Echtzeit / keine Latenz | Anwesenheitsbuchungen und Benutzer-Sync-Ereignisse empfangen |
| RESTful-API | Ihr Server → Gerät | ~15 Sekunden | Benutzer hinzufügen/löschen, Logs laden, Biometrie registrieren |
Erste Schritte
Integrieren Sie in drei Schritten. Ihr Server benötigt eine öffentlich erreichbare URL, um Callbacks zu empfangen.
Callback-URL konfigurieren
Melden Sie sich im API-Monitor-Portal an. Legen Sie die öffentliche HTTPS-URL Ihres Servers als Callback-URL für Ihre Geräte fest. Die API-Engine sendet biometrische Ereignisse per POST in Echtzeit an diesen Endpunkt.
Anwesenheitsbuchungen empfangen
Ihr Endpunkt empfängt einen POST mit rohem JSON-Body — für Callback-APIs sind keine Query-Parameter nötig. Prüfen Sie den AuthToken, verarbeiten Sie die Buchungsdaten und antworten Sie mit {"status":"done"}.
RESTful-APIs zur Verwaltung von Benutzern & Geräten aufrufen
Senden Sie einen JSON-Befehl per POST an die RESTful-Endpunkt-URL in Ihrem API Monitor-Konto, mit Ihrer stgid (Service Tag ID) als Query-Parameter. Die Engine stellt den Befehl in die Warteschlange, und das Gerät bestätigt ihn innerhalb von ca. 15 Sekunden.
Endpunktformat
| API-Typ | Methode | Übermittlung |
|---|---|---|
| Callback-API (eingehend) | POST | Das Gerät sendet per POST an Ihre konfigurierte URL. Roher JSON-Body; keine Parameter. |
| RESTful-API (ausgehend) | POST | Sie senden per POST an die RESTful-Endpunkt-URL (zu finden in Ihrem API Monitor-Konto) mit ?stgid=YOUR_SERVICE_TAG_ID und rohem JSON-Body. |
{"status":"done"} (HTTP 200) zurückgeben, um den Empfang zu bestätigen. Führen Sie vor der Antwort keine aufwendige Verarbeitung durch — stellen Sie sie in eine Warteschlange.
API-Dokumentation
Die Referenz ist nach Themen gegliedert. Beginnen Sie mit der Gerätekompatibilität, dann folgen die Callback- und REST-Operationen.
Kontakt
Für API-Support, Gerätekompatibilität oder Vertriebsanfragen:
Vertrieb & Support
Entwicklerressourcen
Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, 2nd Floor, Cams Biometrics Building, Opposite to Satyabama University, Semmancheri, OMR, Chennai – 600119, Indien.