沃土开放平台

API文档 > 照片管理类 > 人员照片状态查询接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/person/{personGuid}/face/{guid}/state,method:GET
  • 发送人员编号、照片编号和设备序列号至云端,云端根据存有的设备-人员、人员-照片对应关系,返回该照片在人员已授权的所有设备上的注册状态
  • 若设备序列号为空,云端根据存有的设备-人员、人员-照片对应关系,返回该照片在该设备上的注册状态
  • 照片在设备上的注册状态state为3:注册成功,表示照片在设备上注册成功,设备可以识别人员

查询某个人员id对应的某张照片在人员已授权的所有设备上是否注册成功

  • 照片在设备上的注册状态state为1:已上传,指照片已经录入、存储到云端
  • 照片在设备上的注册状态state为2:注册中接口
  • 人员授权到设备,但照片在设备上全部注册失败,则设备无法识别人员,授权未成功
  • 照片在设备上注册失败(state为4)的原因有:人脸框过小、人脸角度过大、不止一个人脸等
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
deviceKey 设备序列号 String N
personGuid 照片所属人员的 id String Y
guid 照片 id String Y
{
	"code": "GS_SUS602",//人员照片状态查询接口调用成功
	"data": [
		{
		"id": 1,//记录id
		"faceGuid": "000142A9171E4795BC656DC9DDAF1534",//照片guid
		"userGuid": 73,//人员所有者(客户)guid
		"deviceKey": "84E0F420001100B0",//设备序列号
		"state": 1,//照片注册状态(1:上传中 2:注册中 3:注册成功 4:注册失败)
		"msg": "",//照片注册说明
		"personGuid": "0001E9FB3ABC4271B583F37B9E29E722"//人员guid
		}
	 ],
	"msg": "success",
	"result": 1
}
state名称 设备状态state 照片在设备上的注册状态state (拍照)注册任务状态state
state说明 1:未绑定,设备-appId绑定关系
2:绑定中,设备与云端确认通信中
3:解绑中,设备删除中,与appId解绑中
4:未同步,云端数据未同步至设备
5:同步中,云端数据正在同步至设备
6:已同步,云端数据已同步至设备
7:已禁用,设备不可被使用
8:禁用中,设备正在“禁用”过程中
9:启用中,设备正在“启用”过程中
1:已上传
2:注册中
3:注册成功
4:注册失败
1:任务创建
2:准备就绪
3:开启失败
4:任务完成
5:任务过期
6:任务失败
出现接口名称
  • 设备查询
  • 设备列表查询
人员照片状态查询
  • 注册任务状态查询
  • 注册任务状态变更