智慧园区 – Byhw's WordPress

一、重要说明

✦ 返回数据
所有接口返回均为标准 JSON，字段说明如下：
code：0-正常，否则存在错误。
msg：说明信息，一般提示错误信息
data：数据部分

✦ Token
① 开发者以供应商提供的 AppKey 和 AppSecret 为依据，通过获取 Token 接口获得 Token。
② 除获取 Token 接口外，所有开放接口调用都需要在 Headers 中加入上一步获取到的 Token 值，Key 为 Token。
③ 请开发者妥善管理 Token，有效期为 2 小时，请勿频繁获取，同时存在的 Token 有数量上限。

✦ 频率限制
出于服务安全性和稳定性考虑，同一个 AppKey，30 秒内调用次数超过 60 次后会被短暂限流，请注意调用频率。

二、接口列表

获取 Token

✦ Method & Uri
POST /hwcloud/rest/opening/br1/token

✦ Headers
Content-Type application/json

✦ Body
{
    "appKey": "***",
    "appSecret":"***" 
}

✦ 返回 data 说明
appId：开放应用 ID
accessToken：其他接口调用凭据
expireMs：过期时间，单位毫秒

获取设备集合

✦ Method & Uri
POST /hwcloud/rest/ipark/br2/getDeviceList

✦ 返回 data 说明
id：设备 ID
sn：设备 SN
name：设备名称
ip：设备 IP
port：设备端口
entryProperty：设备进出属性，1-进，2-出，否则-无
remark：设备备注

获取考勤打卡记录集合

✦ Method & Uri
POST /hwcloud/rest/ipark/br2/getAttRecordList

✦ Headers
Content-Type application/json

✦ Body
# startTime 不可大于 endTime
# 时间跨度不可大于 7 天
# 记录区间为 [startTime, endTime]
{
    "startTime": "2024-10-24 00:00:00",
    "endTime": "2024-10-30 23:59:59"
}

✦ 返回 data 说明
deviceId：设备 ID，具体设备信息可从“获取设备集合”接口获取
name：人员姓名
officeName：部门名称
recordTime：打卡时间，毫秒级时间戳

修改入口：考勤计算规则

权限级别：企业级管理员
功能位置：考勤管理 - 考勤规则设置 - 动态考勤规则

修改入口：考勤展示规则

权限级别：企业级管理员
功能位置：考勤管理 - 考勤规则设置 - 考勤展示规则

修改入口：文件生成规则

权限级别：企业级管理员
功能位置：知识仓库 - 文件生成

修改入口：基础规则

权限级别：基础规则也分企业级规则和系统级规则，系统级规则需要最高权限用户 admin 操作
功能位置：知识仓库 - 基础规则

规则替换方式

✦ 通过筛选条件找到需要更新的脚本

✦ 点击编辑或者规则配置按钮，进入如下配置界面：

✦ 上传脚本文件
# 可以将本地脚本文件拖入文件上传框，或者点击选择来选择本地脚本文件
# 不要忘记点击上传按钮，并且耐心等待上传完成

✦ 点击确定保存更改
# 耐心等待上一步上传完成之后再点击确定
# 除了脚本文件请勿修改任何其他内容

分类：智慧园区

慧维智慧园区开放文档

一、重要说明

二、接口列表

慧维智慧园区脚本更新

归档

分类