沃土开放平台

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