沃土开放平台

API文档 > 人员管理类 > 人员设备授权接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/person/{guid}/devices,method:POST
  • 发送人员编号和所有需要授权的设备的序列号至云端,若人员id已有相应的照片信息,云端服务器将人员和照片信息下发到序列号对应的设备上(一个人员,多台设备),设备能成功够识别人员并显示名字,则授权成功
  • 若传入passTimes,人员可识别,但若人员在非允许时间段内识别,设备会提示“姓名+权限不足”;若设备开启语音播报,则会播报“权限不足”;若设备串口输出连接门禁,则不会开门
  • 用于单个添加人员,可为一个人员添加多个设备序列号,人员和设备为一对多的关系
  • 可在短时间内完成,不需要等待云端数据同步至设备
  • 调用此接口一次只能对单个人员添加设备授权(一个人员,多台设备),建议与需要等待数据同步的设备授权人员接口(一台设备,多个人员)区别使用
  • 识别回调增加字段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_SUS204",//人员设备授权接口调用成功,若设备在线,则设备接收并添加人员信息;若设备离线,则联网后自动进行接收授权人员信息
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
guid 需授权的人员 String Y
deviceKeys 所有需授权的设备 String Y deviceKey 通过英文逗号拼接而成
passTimes 允许进入的时间段 String N 范围为[00:00:00,23:59:59],格式说明见备注
{
	"code": "GS_SUS204",//人员设备授权接口调用成功
	"msg": "success",
	"result": 1
}