沃土开放平台

API文档 > 设备管理类 > 设备授权人员接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/device/{deviceKey}/people,method:POST
  • 发送设备序列号和人员id列表至云端,云端存入设备-人员的对应关系,设备30s后向云端服务器请求同步,云端内存储的全部人员数据信息同步给设备
  • 设备能够成功识别人员并显示人员信息,则设备授权人员成功
  • 设备(批量)授权人员,是指一台设备授权给多个人员(一对多),授权成功即指设备能够成功识别人员
  • 若传入passTimes,人员可识别,但若人员在非允许时间段内识别,设备会提示“姓名+权限不足”;若设备开启语音播报,则会播报“权限不足”;若设备串口输出连接门禁,则不会开门
  • 设备能够成功识别人员并显示人员信息,则设备授权人员成功
  • 设备(批量)授权人员,是指一台设备授权给多个人员(一对多),授权成功即指设备能够成功识别人员
  • 设备管理(创建、绑定、同步、修改配置)完成,人员、照片信息录入存储到云端后,调用此接口将用户群体添加到某台设备上
  • 人员、照片数据信息从云端同步到设备后,该台设备能够识别id列表里的所有人员,则授权成功
  • 调用设备授权人员接口后,设备会自动进行同步,云端将新增人员的数据信息同步至设备,同步需要一定时间
  • 本接口推荐在统一批量授权时使用,调用接口后,需等待云端数据同步到设备
  • 识别回调增加字段type:0(默认值):时间段内,1:时间段外,2:陌生人
  • passTimes格式(startTime,endTime英文逗号隔开):09:00:00,11:00:00,13:00:00,15:00:00,17:00:00,19:00:00
  • passTimes最多可设置3段,若只设置1段,则后两段不传即可,如:09:00:00,11:00:00
  • passTimes报错类型:时间段参数数量不正确或超出3段限制、时间段参数后时间段早于前时间段、时间段参数超出限制、时间段参数格式错误
  • 若要更新人员的passTimes,则需再次对人员进行授权;调用授权接口并重新传入passTimes
  • "code": "GS_SUS327,//设备授权人员接口调用成功,若设备在线,则进入同步状态,云端新增的人员数据信息同步到设备上;若设备离线,则联网后自动进行同步
注意:本接口强烈推荐在统一大批量授权时使用(调用此接口,设备将重新同步)
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
deviceKey 设备序列号 String Y
personGuids 员工 GUID列表 String Y 英文逗号隔开
passTimes 每日允许进入的时间段 String N 范围为[00:00:00,23:59:59],格式说明见备注
facePermission 刷脸权限 Int N 1:关;
2:开;
若字段不填,默认为 2
cardPermission 刷卡权限 Int N 1:关;
2:开;
若字段不填,默认为 2
cardFacePermission 人卡合一权限 Int N 1:关;
2:开;
若字段不填,默认为 2
idcardFacePermission 人证比对权限 Int N 1:关;
2:开;
若字段不填,默认为 2
effectiveTime 有效期到后,删除该人员 String N 以服务器系统时间为准,当人员权限时间到期时,删除该人员权限。
传入时间格式为(年-月-日 时:分:秒):2017-07-15 12:05:00
{
	"code": "GS_SUS327,//设备授权人员接口调用成功  
	"msg": "success",
	"result": 1
}