1.5.2.1.1. 设备初始化推送
- 设备第一次初始化时推送设备基本信息
Request:
{
"sid": "dse.push.deviceInit",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "设备号",
"timezone": "+08:00",
"alais": "一楼打卡机",
"model": "iFace702",
"type": "0",
"status": 1,
"enable": 1,
"remoteIp": "110.80.38.76",
"initTimeStamp": 1557910639
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
timezone | String | 设备时区 |
alais | String | 设备别名 |
model | String | 设备型号 |
type | String | 设备类型,0代表考勤设备,1代表门禁设备,2代表人证设备,999代表未知设备 |
status | Integer | 设备在线状态,1代表在线,0代表离线 |
enable | Integer | 设备启用状态,1代表启用,0代表禁用 |
remoteIp | String | 设备公网Ip地址 |
initTimeStamp | Long | 设备初始化时间戳 |
回复信息请参看规范说明
1.5.2.1.2. 设备状态变化推送
- 设备状态发生变化时推送设备状态信息
Request:
{
"sid": "dse.push.deviceStatus",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "设备号",
"status": 1,
"changeTimeStamp": 1557910639
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
status | Integer | 设备在线状态,1代表在线,0代表离线,2代表重置 |
changeTimeStamp | Long | 设备状态变化时间戳 |
注意:
当设备状态为重置时,代表使用者在设备端恢复出厂设置,这时设备的数据已清空,dbs自动解绑设备;所以第三方系统收到重置的状态后也需要做删除设备操作,保证第三方系统和dbs之间数据一致。
回复信息请参看规范说明
1.5.2.1.3. 生物特征远程登记进度通知
远程控制登记生物特征后,实时上报用户登记生物特征的状态.
使用须知:
- 不同设备对于登记生物特征回传的次数不同,正常是回传3次,以end结束标识为准;
- 该通知与登记生物特征配对,若手动打开设备登记窗口没有此提示;
Request:
{
"sid": "dse.push.registerTipBio",
"mid": "xxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "xxxx",
"num": "xxxx",
"code": "xxxx",
"message": "xxxx",
"end": "1",
"sessionId": "xxxx"
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
num | String | 第N次生物特征登记 |
code | String | 第N次生物特征登记返回值 |
message | String | 第N次生物特征登记返回值对应的消息内容 |
end | String | 结束标识,1:结束,0:否(默认) |
sessionId | String | 会话唯一标识,与登记生物特征匹配 |
code与message消息列表:
code | message |
---|---|
0 | 成功 |
-1 | 用户不存在 |
-2 | 指纹容量已满 |
-3 | 指纹重复 |
-4 | 超时退出 |
-5 | 指纹合成失败 |
-6 | 获取数据异常 |
-7 | 添加到内存失败 |
-8 | 手掌容量已满 |
-9 | 手掌重复 |
-10 | 模板提取异常【位置不对】 |
-11 | 手掌离摄像头距离不对 |
-12 | 其他异常 |
回复信息请参看规范说明
1.5.2.1.4. 生物特征登记通知
设备端登记生物特征后推送,第三方在收到此消息之后,可查询对应的生物特征信息。生物特征查询目前只提供查询人员人脸照片
Request:
{
"sid": "dse.push.registerBiometric",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"employeeNo": "人员编号",
"type": "1",
"registerTimeStamp": 1557910639
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
employeeNo | String | 人员编号 |
type | String | 生物特征类型,详见生物特征类别说明,如type="1"时,表示在设备上登记指纹 |
registerTimeStamp | Long | 设备登记生物特征上传到服务端的时间戳 |
回复信息请参看规范说明