Zkteco-js NPM | npm.io

Warning

⚠️ This repository is not recommended for use in production. ⚠️

This repository is currently in development and may contain bugs or incomplete features. Use at your own risk and do not deploy to a production environment.

About zkteco-js

The zkteco-js library provides a robust solution for Node.js developers to interface with ZK BioMetric Fingerprint Attendance Devices. Its user-friendly API allows seamless extraction of data, such as registered users, logs, and device versions. Developers can also add users, retrieve real-time logs, and clear attendance records. Using a socket connection, the library ensures fast and reliable data exchange. Whether creating an attendance system or a time-and-attendance management application, zkteco-js is the essential tool for integrating biometric devices efficiently.

Installation

npm i zkteco-js

Or, if you prefer Yarn:

yarn add zkteco-js

Usage Example

const Zkteco = require("zkteco-js");

const manageZktecoDevice = async () => {
    const device = new Zkteco("192.168.1.106", 4370, 5200, 5000);

    try {
        // Create socket connection to the device
        await device.createSocket();

        // Retrieve and log all attendance records
        const attendanceLogs = await device.getAttendances();
        console.log(attendanceLogs);

        // Listen for real-time logs
        await device.getRealTimeLogs((realTimeLog) => {
            console.log(realTimeLog);
        });

        // Manually disconnect after using real-time logs
        await device.disconnect();
    } catch (error) {
        console.error("Error:", error);
    }
};

manageZktecoDevice();

API Reference :

createSocket() - Establishes a connection to the device.
getInfo() - Provides general information about the device, including log capacity and user count.
getUsers() - Retrieves an array of all users stored on the device.
setUser(uid, userid, name, password, role = 0, cardno = 0) - Adds a new user to the device.
🆕 deleteUser(uid) - Delete an user from the device.
getAttendances() - Retrieves an array of all attendance logs from the device.
getRealTimeLogs(callback) - Sets up a real-time log stream and calls the provided callback function with each new log entry.
getPIN() - Retrieves the device PIN.
getTime() - Retrieves the current time from the device.
🆕 setTime(DateTime) - Updates the device's time.
getFaceOn() - Checks if the device's Face On feature is enabled.
getSSR() - Retrieves the device's Self-Service Recorder (SSR) status.
getDeviceVersion() - Retrieves the device's firmware version.
getDeviceName() - Retrieves the device's name.
getPlatform() - Retrieves the device's platform version.
getOS() - Retrieves the device's operating system version.
getAttendanceSize() - Retrieves the total number of attendance records stored on the device.
clearAttendanceLog() - Clears all attendance logs from the device.
disconnect() - Disconnects the device from the network.
🆕 clearData() - Clear All Data from the device (all users,attendances logs etc ).
🆕 voiceTest() - Voice Test.
🆕 getVendor() - get vendor name.
🆕 getProductTime() - get product created time.
🆕 getMacAddress() - get device MAC address.