1.5.4.1.1. 门初始化
门禁设备,在激活时DBS初始化门信息时推送,第三方在收到此消息之后,可通过查询门信息查询具体门信息
Request:
{
"sid": "dse.push.doorInit",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "设备号"
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
回复信息请参看规范说明
1.5.4.1.2. 读头初始化
控制器设备,在设备激活后,DBS初始化门信息时推送,第三方在收到此消息之后,可通过查询读头信息查询具体读头信息
Request:
{
"sid": "dse.push.readerInit",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "设备号"
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
回复信息请参看规范说明
1.5.4.1.3. 辅助输入初始化
控制器设备,在设备激活后,DBS初始化辅助输入信息时推送,第三方在收到此消息之后,可通过查询辅助输入信息查询具体辅助输入信息
Request:
{
"sid": "dse.push.auxInInit",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "设备号"
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
回复信息请参看规范说明
1.5.4.1.4. 辅助输出初始化
控制器设备,在设备激活后,DBS初始化辅助输出信息时推送,第三方在收到此消息之后,可通过查询辅助输出信息查询具体辅助输出信息
Request:
{
"sid": "dse.push.auxOutInit",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"sn": "设备号"
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
回复信息请参看规范说明
1.5.4.1.5. 门禁事件
- 注意:以核验时间点开始计算,该数据仅在dbs保留45天,超过45天的数据将彻底删除,不支持记录追溯。
Request:
{
"sid": "dse.push.acc.transaction",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"transactions": [{
"logId": "xxxxxx",
"sn": "20000000001",
"doorNum": 1,
"operator": "2596",
"time": "2019-06-03T09:01:01+08:00",
"inOutState": 1,
"eventCode": "N00001",
"verified": 1,
"temperature": "36.1",
"maskStatus": "1",
"tempUnit": "0"
}]
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
logId | String | 记录id,每条记录生成一个记录id,与门禁照片推送的 logId 关联一一对应 |
sn | String | 设备序列号 |
doorNum | Integer | 门编号 |
operator | String | 操作者,当验证通过时应为人员编号或访客编号,若远程开门时为远程开门时下发的操作者名称 |
time | String | 核验时间,ISO8601时间格式,如2020-06-03T09:01:01+08:00 |
inOutState | Integer | 出入状态,0:入,1:出,2:未知 |
eventCode | String | 事件码,详见门禁实时事件码说明 |
verified | Integer | 验证方式,详见验证方式说明 |
temperature | String | 体温,此属性配合设备使用,当设备带体温检测功能才有返回值;若测温设备关闭测温功能则上传的值为255; |
tempUnit | String | 温度单位,0:温度以摄氏度单位推送(默认),1:温度以华氏度单位推送 |
maskStatus | String | 是否佩戴口罩,0 未佩戴口罩,1 已佩戴口罩。此属性配合设备使用,当设备带口罩检测功能才有返回值;若测温设备关闭口罩检测功能则上传的值为255; |
回复信息请参看规范说明
1.5.4.1.6. 门禁照片
- 注意:以核验时间点开始计算,该数据仅在dbs保留45天,超过45天的数据将彻底删除,不支持记录追溯。
Request:
{
"sid": "dse.push.acc.verifyPhoto",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"verifyRecords": [{
"logId": "xxxxxx",
"sn": "设备号",
"operator": "人员编号",
"time": "2019-06-03T09:01:01+08:00",
"photo": "xxxxxxxxxxxxxxxxxxxxx"
}]
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
logId | String | 记录id,每条记录生成一个记录id,与门禁事件推送的 logId 关联一一对应 |
sn | String | 设备序列号 |
operator | String | 操作者编号 |
time | String | 核验时间,ISO8601时间格式, 如2020-12-30T00:00:00+08:00 |
photo | String | 核验照片base64格式 |
注意:
可根据sn+operator+time作为唯一值,匹配对应的门禁事件
回复信息请参看规范说明
1.5.4.1.7. 门实时状态
Request:
{
"sid": "dse.push.acc.realDoorStatus",
"mid": "xxxxxxxx",
"payload": {
"params": {
"companyId": "xxxxx",
"companyCode": "xxxx",
"status": [{
"sn": "20000000001",
"doorNum": "1",
"sensor": "2",
"relay": "1",
"alarm": "0",
"coerce": "0",
"time": "2020-06-03T09:01:01+08:00"
}]
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
companyId | String | dbs平台内部公司唯一标识 |
companyCode | String | 与创建公司时传入的一致,一般表示第三方系统内部公司唯一标识 |
sn | String | 设备序列号 |
doorNum | String | 门编号 |
sensor | String | 门磁开关状态, 0:当前门无门磁, 1:当前门有门磁(门是关闭状态), 2:当前门有门磁(门是打开状态) |
relay | String | 门继电器开关状态, 0:继电器吸合, 1:继电器断开 |
alarm | String | 报警状态, 0:无报警, 1:意外开门事件, 2:门磁超时报警 |
coerce | String | 胁迫状态, 0:无胁迫, 1:密码, 2:指纹 |
time | String | 实时状态时间,ISO8601时间格式,如2020-06-03T09:01:01+08:00 |
回复信息请参看规范说明