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. 生物特征远程登记进度通知

远程控制登记生物特征后,实时上报用户登记生物特征的状态.

使用须知:

  1. 不同设备对于登记生物特征回传的次数不同,正常是回传3次,以end结束标识为准;
  2. 该通知与登记生物特征配对,若手动打开设备登记窗口没有此提示;

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 设备登记生物特征上传到服务端的时间戳

回复信息请参看规范说明

results matching ""

    No results matching ""