Startseite / Produkte / APIs / Biometric Gateway Web API

API

Biometric Gateway Web API

Die Biometric Gateway Web API (auch bekannt als Universal Biometric Web API 3.0) verwandelt jedes unterstützte Gerät für Fingerabdruck, Gesicht, Handfläche, Venen, Iris, Retina, Karte oder Passwort in einen cloudverbundenen Endpoint, mit dem Ihre Anwendung von überall auf der Welt kommunizieren kann. Empfangen Sie Stempelungen in Echtzeit im Moment des Geschehens und verwalten Sie Benutzer auf dem Gerät aus der Ferne – alles über einen einfachen Vertrag aus REST plus Callback.

Loslegen Entwicklerdokumentation

Überblick

Verbinden Sie jedes internetfähige biometrische Zeiterfassungs- oder Zutrittskontrollgerät direkt per HTTP mit Ihrer Webanwendung – ohne lokale Software, PC oder Datenbank.

Die Flaggschiff-Web-API von Cams ermöglicht die Maschine-zu-Server-Kommunikation zwischen entfernt installierten biometrischen Geräten und Ihrer Serveranwendung. Ein Gerät verbindet sich mit dem Internet, die Anwesenheit wird in Echtzeit an Ihre Callback-URL (Webhook) gesendet, und Ihr Server steuert Geräteoperationen wie Benutzer hinzufügen oder löschen, Templates senden, Fotos senden und Stempel-Logs laden über RESTful-Aufrufe. Desktop-Software, eine lokale Datenbank oder ein dauerhaft im LAN laufender PC sind nicht nötig. Die API ist datenbankunabhängig und funktioniert mit jeder Backend-Sprache.

APIRESTCallback/Webhook (HTTP POST)MQTT (Pfad mit dauerhafter EMQX-Verbindung)PHPPythonJavaNode.js

Im Einsatz bei:Besucherverwaltung Events, Festivals & Stadien

Callback (Webhook) – Stempelung in Echtzeit

# 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"
}

Funktionen

Was er kann

Anwesenheit in Echtzeit

Stempelungen werden an Ihre Callback-URL gesendet, sobald sie auf dem Gerät erfasst werden.

Benutzerverwaltung aus der Ferne

Benutzer hinzufügen, löschen, sperren und verschieben sowie Templates oder Fotos per RESTful-Aufruf von Ihrem Server an Geräte senden.

Multimodale Erfassung

Ein Vertrag deckt Eingaben per Fingerabdruck, Gesicht, Handfläche, Vene, Iris, Retina, Karte und Passwort ab.

Offline-Ausfallsicherheit

Offline-Stempelungen werden auf dem Gerät zwischengespeichert und nach Wiederherstellung der Verbindung in der richtigen Reihenfolge nachgesendet.

Verschlüsselter Transport

Die AES-256-Verschlüsselung der Rohdaten lässt sich pro Gerät für einen sicheren Datenaustausch aktivieren.

Merkmale

Alles inklusive

Die Callback-API (Webhook) liefert Anwesenheitsstempelungen in Echtzeit vom Gerät zu Ihrem Server – ohne Polling-Latenz
RESTful-API für Server-zu-Gerät-Operationen: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog und mehr (38 Operationen)
Erfasst mehrere Eingabetypen pro Stempelung: Fingerabdruck, Gesicht, Karte, Handfläche, Fingervene, Iris, Retina, Passwort sowie Körpertemperatur- und Gesichtsmasken-Flags, sofern die Hardware dies unterstützt
Stempeltypen: CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Verarbeitet Offline-Stempelungen: zwischengespeicherte Daten werden nach dem Wiederverbinden des Geräts der Reihe nach übertragen
Optionale AES-256-Verschlüsselung aller ausgetauschten Rohdaten, mit einem im API Monitor festgelegten Sicherheitsschlüssel
Die LoadLog-API ermöglicht Anwendungen ohne Server und reinen LAN-Anwendungen, bis zu 30 Tage Anwesenheitshistorie auf Abruf zu laden
Dokumentierte Statuscodes für robuste Fehlerbehandlung, mit AuthToken pro Gerät und OperationID-Tracing für Support und Abstimmung

Mit der Biometric Gateway Web API entwickeln

Schlüssel holen, Dokumentation lesen und live gehen. Unser Team unterstützt Sie bei Ihrer ersten Integration.

Mit einem Ingenieur sprechen WhatsApp

FAQ

Häufige Fragen

Muss ich für die Web API Software in meinem lokalen Netzwerk installieren?

Nein. Die Kommunikation erfolgt per HTTP zwischen dem Gerät und Ihrem Server. Solange das Gerät mit dem Internet verbunden ist, können Sie Anwesenheit empfangen und Benutzer verwalten – ohne lokale Software, Datenbank oder PC.

Welche biometrischen Eingaben unterstützt die Web API?

Fingerabdruck, Gesicht, Karte, Handfläche, Fingervene, Iris, Retina und Passwort, plus Körpertemperatur- und Gesichtsmaskendaten, sofern die Hardware sie liefert.

Was ist der Unterschied zwischen der Callback-API und der RESTful-API?

Die Callback-API ist die Echtzeit-Kommunikation vom Gerät zum Server über eine URL, die Sie auf Ihrem Server bereitstellen (keine Latenz). Die RESTful-API ist die Kommunikation vom Server zum Gerät, die Sie am Endpoint von Cams aufrufen, um das Gerät zu verwalten, mit einer Latenz von bis zu etwa 15 Sekunden.

Kann ich die API nutzen, wenn mein Server keine öffentliche IP hat?

Ja. Nutzen Sie die LoadLog-API, um Anwesenheits-Logs für einen bestimmten Zeitraum auf Abruf zu laden, solange das Gerät mit dem Internet verbunden ist.