Einführung
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.
38 Operationen — 11 Callback-APIs (Gerät → Server) und 27 RESTful-APIs (Server → Gerät). Alle Payloads sind rohes JSON über HTTP/HTTPS.
Alle biometrischen Geräte werden unterstützt. Cams-Geräte, verifizierte Geräte und Marken von Drittanbietern (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC und weitere). Wählen Sie den
Verbindungsmodus, der zu Ihrer Umgebung passt.
So funktioniert es
Das Biometric Gateway besteht aus:
Gateway-ServerCloud-Plattform mit der Cams Protocol Engine (Protokollübersetzung, Datennormalisierung, Offline-Zwischenspeicherung, Authentifizierung) und der standardisierten API-Schicht, die Ihrer Anwendung eine einheitliche Schnittstelle bietet.
Protocol EngineDie zentrale Engine im Gateway-Server, die mit den biometrischen Geräten kommuniziert, herstellerspezifische Protokolle übersetzt und die sichere Protokollierung von Datentransaktionen sowie die Identitätsverwaltung übernimmt.
Protocol Engine LiteEine On-Premise-Version, die auf Ihrem eigenen Server (Windows/Linux) installiert werden kann — für reine LAN- oder selbst gehostete Umgebungen. Dieselbe API, lokal bereitgestellt.
Integriert mit
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Individuelle Web-Apps
Ihre Anwendung
ERP
HRMS
Payroll
Schul-ERP
KI-Workflow (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Individuelle Apps
Protocol Engine
Sichere Authentifizierung
Protokollierung von Datentransaktionen
Protokollübersetzung
Offline-Cache & Warteschlange
AES-256-Verschlüsselung · Auth-Token-Prüfung
Standardisierte API-Schicht
Identitätsverwaltung
KI-/MCP-Integration
Callback-Dispatcher
REST-Command-Router
Datennormalisierung · Protokollunterstützung für mehrere Marken
Fingerabdruck
·
Gesichtserkennung
·
Handvenen
·
RFID-Karte
·
PIN
·
QR / Barcode
·
GPS-Ortung
Biometrische Geräte — Alle Marken werden unterstützt
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ viele weitere
| 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 |
Einführung
Erste Schritte
Integrieren Sie in drei Schritten. Ihr Server benötigt eine öffentlich erreichbare URL, um Callbacks zu empfangen.
1
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.
2
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"}.
3
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. |
Beantworten Sie Callback-Anfragen immer sofort. Ihr Server muss {"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.
Dokumentation
API-Dokumentation
Die Referenz ist nach Themen gegliedert. Beginnen Sie mit der Gerätekompatibilität, dann folgen die Callback- und REST-Operationen.
Unterstützte Geräte und VerbindungsmodiWelche Geräte das Gateway unterstützt, wie sich jedes Gerät verbindet (Native Push oder Hybrid Push) und welche API-Operationen in welchem Modus verfügbar sind.
API-Referenz: Architektur, Felder und StatuscodesDie Bausteine, die alle Operationen gemeinsam haben: Anfrageablauf, allgemeine JSON-Felder, Template-Typen, Statuscodes, Ports und Payload-Verschlüsselung.
Callback-APIs: Echtzeit-Ereignisse vom Gerät an Ihren ServerJedes Ereignis, das ein Gerät an Ihre Callback-URL sendet, mit dem JSON, das Ihr Server erhält, und der Antwort, die er zurückgeben muss.
RESTful-APIs: Befehle von Ihrem Server an das GerätBefehle, die Ihr Server über das Gateway an ein Gerät sendet, jeweils mit Request- und Response-JSON.
Die API lokal testenSo empfangen Sie Geräte-Callbacks auf einem Entwicklungsrechner und testen REST-Befehle mit Postman, bevor Sie live gehen.
PHP-Beispiel: Biometrische Anwesenheit in MySQL speichernEin funktionierender PHP-Callback-Handler, der Anwesenheitsbuchungen in drei Schritten in MySQL speichert.
Prompts für KI-CodegeneratorenKopieren Sie einen Prompt in Ihren KI-Assistenten, um Integrationscode für Ihren eigenen Stack zu generieren.
FAQ, SDK und KostenHäufige Fragen von Integratoren sowie Informationen dazu, wie SDK und API-Preise funktionieren.
