如何获取海康威视DS-K1T343人脸终端ISAPI端点及今日考勤统计

1. 关键ISAPI端点 #

DS-K1T343遵循海康威视ISAPI规范，核心相关端点如下：

• 设备连通性验证：/ISAPI/System/status（GET请求）
• 原始考勤事件查询：/ISAPI/AccessControl/AcsEvent?format=json（POST请求）
• 考勤统计数据查询：/ISAPI/AccessControl/AcsStatistics（POST请求）

所有请求必须携带HTTP Basic认证，请求头添加Authorization: Basic [base64编码的用户名:密码]，用户名密码为终端的管理账号信息。

2. 今日考勤统计查询实操 #

前置准备 #

先在终端Web后台开启ISAPI服务：进入【系统配置】→【网络配置】→【高级配置】，勾选启用ISAPI。

请求构造 #

向http://[你的设备IP]/ISAPI/AccessControl/AcsStatistics发送POST请求，Body为JSON格式，指定今日时间范围和统计类型：

{
  "AcsStatistics": {
    "searchID": "unique-search-id-123",
    "timeRange": {
      "startTime": "2024-05-20T00:00:00+08:00",
      "endTime": "2024-05-20T23:59:59+08:00"
    },
    "statisticsType": "attendance",
    "includeSubRegions": false
  }
}

• searchID：自定义唯一标识，用于追踪请求
• timeRange：替换为当前日期的起止时间，时区需与设备匹配（通常为+08:00）

响应解析 #

成功响应的JSON会包含核心统计字段：

• totalAttendance：今日总考勤人次
• normalAttendance：正常考勤次数
• lateAttendance：迟到次数
• earlyLeave：早退次数

如果需要原始打卡记录而非统计数据，可改用/ISAPI/AccessControl/AcsEvent端点，请求Body中指定相同的时间范围即可。

内容的提问来源于stack exchange，提问作者Bahrom Najmiddinov