ZKTeco ADMS Protocol

Last updated: 8/28/2026

ZKTeco ADMS Push Protocol

The device initiates all connections — the server never connects to the device.

Protocol Flow

Device                               Server
  │                                    │
  │── GET /iclock/cdata?SN=ABC123 ───►│ Register / heartbeat
  │◄── "GET OPTION FROM: ABC123..." ──│ Config response
  │                                    │
  │── POST /iclock/cdata (ATTLOG) ───►│ Push attendance logs
  │◄── "OK"                           │
  │                                    │
  │── GET /iclock/getrequest ────────►│ Poll for commands
  │◄── "C:uuid:REBOOT" (if queued)    │
  │                                    │
  │── POST /iclock/devicecmd ────────►│ Command result
  │◄── "OK"                           │

Attendance Log Format (POST /iclock/cdata)

ATTLOG
EnrollNumber\tDateTime\tVerifyMode\tInOutStatus\tWorkCode\t
1001\t2024-01-15 08:30:00\t1\t0\t0\t
1002\t2024-01-15 09:05:00\t1\t0\t0\t

Command Format (GET /iclock/getrequest response)

C:cmd_uuid:REBOOT\r\n
C:cmd_uuid:DATA UPDATE USERINFO PIN=1001\tName=John\tPassword=\tCard=0