{"openapi": "3.0.3", "info": {"title": "IoT.sy ZK-Bridge REST & ADMS API", "version": "2.0.0", "description": "Bi-directional ZKTeco ADMS Push gateway with Attendance Logs, Biometrics, Remote FP/Face Enrollment, Webhooks, and MQTT."}, "paths": {"/api/health": {"get": {"summary": "Bridge & MQTT health summary"}}, "/api/devices": {"get": {"summary": "List connected ZKTeco ADMS terminals"}}, "/api/punches": {"get": {"summary": "Query attendance punches (?sn=&pin=&verify=&since=&limit=)"}}, "/api/punches.csv": {"get": {"summary": "Download CSV report of attendance punches"}}, "/api/users": {"get": {"summary": "List synced terminal users with template counts"}}, "/api/biometrics": {"get": {"summary": "List synced FP/Face/Biodata templates (?include_tmp=1 for Base64)"}}, "/api/oplogs": {"get": {"summary": "List terminal operation audit logs (OPLOG)"}}, "/api/photos": {"get": {"summary": "List captured user & attendance photos"}}, "/api/commands": {"get": {"summary": "List queued commands and device ACK statuses"}}, "/api/command": {"post": {"summary": "Queue ADMS command (ENROLL_FP, ENROLL_BIO, ADD_USER, OPEN_DOOR, QUERY_DATA, SYNC_ALL, REBOOT, RAW)"}}, "/api/config": {"post": {"summary": "Save webhookUrl, webhookSecret, apiKey, mqttPrefix"}}, "/api/webhook/test": {"post": {"summary": "Send sample JSON event to configured webhookUrl"}}}}