Support Hub/API & Integrations/ZKTeco-Biometriegeräte per API mit Cloud-Apps integrieren
Translated from the English article and reviewed by a person. Read the English original
Fix

ZKTeco-Biometriegeräte per API mit Cloud-Apps integrieren

ZKTeco-Biometriegeräte per API mit Cloud-Apps integrieren

Biometrische Zeiterfassungssysteme werden für moderne Unternehmen, die effiziente Abläufe und höhere Sicherheit anstreben, zunehmend unverzichtbar. Die Integration von ZKTeco-Biometriegeräten in Cloud-Anwendungen gelingt problemlos mit der Cams Biometrics API, die eine Vielzahl von Geräten unterstützt, darunter auch Geräte von ZKTeco.

Cams-Biometriegeräte

Wenn Sie Biometriegeräte von Cams besitzen (aufgeführt unter http://camsbiometrics.com/product/home.html), müssen Sie das Gerät nicht mit unserem Bot verifizieren. Alle Cams-Biometriegeräte können über eine Web-API betrieben werden. Unser Bot (https://developer.camsbiometrics.com) dient dazu, Geräte anderer Marken auf ihre API-Kompatibilität zu prüfen. Bitte fahren Sie fort, wenn Sie Biometriegeräte anderer Marken als Cams verwenden.

Prüfung der API-Unterstützung für ZKTeco-Hardware

Stellen Sie vor Beginn der Integration sicher, dass Ihr ZKTeco-Gerät für die Web-API-Kommunikation geeignet ist. Dies lässt sich überprüfen, indem Sie Ihr Gerät über den Developer-Bot unter https://developer.camsbiometrics.com verifizieren. Geben Sie die angeforderten Angaben sowie die korrekte Seriennummer des Geräts ein und klicken Sie auf die Schaltfläche „Verifizierung starten“. Der Bot zeigt anschließend TODO/ACTION-REQUIRED-Anweisungen an. Befolgen Sie diese sorgfältig am Biometriegerät, etwa indem Sie einen Benutzer hinzufügen oder eine Stempelung erfassen. Beachten Sie, dass Sie auch dann einen neuen (Dummy-)Benutzer anlegen müssen, wenn bereits Benutzer auf dem Gerät vorhanden sind, sofern der Bot dies verlangt.

Sobald das Gerät erfolgreich verifiziert wurde, wenden Sie sich an das Cams-Vertriebsteam unter +91-98409-41006 (Anruf/WhatsApp) oder per E-Mail an sales@camsbiometrics.com, um die Rechnung für die API zu erstellen.

Der API-Zugang wird Ihrem Gerät unmittelbar nach Erstellung der Steuerrechnung freigeschaltet.

Erfolgsbilanz unterstützter Geräte

Die Plattform developer.camsbiometrics.com führt eine Erfolgsbilanz verschiedener Biometriemodelle. Sie zeigt, wie zuverlässig die einzelnen Geräte bei der Integration mit Cloud-Anwendungen arbeiten. Dies sind die fünf ZKTeco-Modelle mit den höchsten Erfolgsquoten in der API-Kommunikation:

  • Beachten Sie, dass alle Cams-Biometriegeräte, die unter https://camsbiometrics.com/product/home.html aufgeführt sind, von Haus aus API-fähig sind. Die folgenden Angaben gelten nur für ZKTeco- und andere Markenmodelle.
  • Traditionelle Modelle
    • IN02-A: 97 % Erfolgsquote
    • UFace 800: 96 % Erfolgsquote
    • S922: 96 % Erfolgsquote
    • F19: 93 % Erfolgsquote
    • IFace 880: 92 % Erfolgsquote
  • Modelle mit sichtbarem Licht (VL)
    • 94 % aller Geräte der Serie V5Lx werden unterstützt
    • 88 % aller Geräte der Serie V4Lx werden unterstützt
  • Andere Marken
    • 80 %+ eSSL-Geräte
    • 80 %+ ältere BioMax-Modelle
    • 80 %+ Identix-Geräte
    • 20 %+ Mantra-Geräte (es traten mehrfach Datenverlustprobleme auf, daher für die API-Kommunikation nicht empfohlen)
    • RealTimeBiometrics – Wir arbeiten eng mit dem zuständigen Team zusammen, um die Unterstützung zu starten.

Nicht unterstützte Geräte

Die folgenden Marken wurden 2023 aufgrund wiederholter Ausfälle eingestellt, etwa verlorener Stempelungen und nicht behebbarer Datenbeschädigungen. Wir konnten keine Unterstützung der Hersteller erhalten, um diese Probleme dauerhaft zu lösen. Daher werden wir diese Marken nicht unterstützen, bis wir ausreichende Hilfe von den Ingenieurteams der jeweiligen Hersteller erhalten.

  • HikVision
  • Secureye
  • Secugen
  • Suprema

Die oben genannten Marken machen weniger als 3 % des weltweiten Marktes aus. Kunden können diese daher übergehen und sich für besser geeignete Alternativen entscheiden. Diese Modelle können jedoch in lokalen Netzwerken und mit Desktop-Anwendungen weiterhin gut funktionieren.


Diese Statistiken unterstreichen, wie wichtig es ist, die Eignung jedes Geräts zu prüfen, um eine erfolgreiche Integration mit Ihren Cloud-Anwendungen sicherzustellen.

Bitte beachten Sie, dass sich die Firmware im Laufe der Zeit und je nach Region unterscheiden kann. Allein anhand des Modells lässt sich daher nicht sicher feststellen, ob ein Gerät mit der API funktioniert. In der Regel können Geräte mit ADMS, WDMS oder einem integrierten Cloud-Server zur Prüfung der Kompatibilität herangezogen werden.

Lässt sich die API-Unterstützung ohne diese Prüfung bestätigen?

Die Prüfung der API-Unterstützung ist unerlässlich, da die Firmware von ZKTeco-Geräten variiert, und zwar je nach Land und im Laufe der Zeit, selbst bei demselben Modell. Außerdem wird die ADMS-Funktion selten genutzt, weshalb der Hersteller sie nur begrenzt testet. Dies kann zu Problemen wie Datenverlust, beschädigten Datenübertragungen und nicht reagierenden Befehlen während der Transaktionen führen. Daher ist diese Prüfung zwingend erforderlich, um die API-Kompatibilität mit ZKTeco-Biometrie-Zeiterfassungs- oder Zutrittskontrollgeräten zu bestätigen.

Wenn Sie API-unterstützte Geräte ohne diese Prüfung suchen, können Sie Cams-Biometriegeräte in Betracht ziehen.

Gerät mit dem Netzwerk verbinden

Das ZKTeco-Gerät muss mit dem Internet verbunden sein, damit es mit dem Developer-Portal kommunizieren kann. Stellen Sie sicher, dass die Konfigurationen, die unter https://forum.camsbiometrics.com/network-and-server-setup-guide-to-verify-compatibility-of-third-party-biometric-devices/ beschrieben sind, auf der Biometrie-Hardware umgesetzt werden.

Zusätzlich sollte das Gerät für eine effektive Verifizierung online sein. Hilfe dazu, wie das Gerät online geschaltet wird, finden Sie unter https://forum.camsbiometrics.com/how-to-bring-the-cams-biometrics-machine-online/.

Integrations-API

Lesen Sie die API-Dokumentation vollständig und sorgfältig durch und implementieren Sie die Software für eine nahtlose Integration. Nach dem Kauf der API können Sie Ihre Callback-API-URL im Cams-Admin-Panel für das Gerät konfigurieren.

Sobald die API aktiviert ist, werden die Stempelungsdaten in Echtzeit sofort an Ihren Server übertragen.

Die API-Dokumentation finden Sie unter https://camsbiometrics.com/application/biometric-web-api.html.

Was this article helpful?