沃土开放平台

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],格式说明见备注
{
	"code": "GS_SUS327,//设备授权人员接口调用成功  
	"msg": "success",
	"result": 1
}