沃土开放平台

API文档 > 照片管理类 > 人员照片注册接口(url)
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/person/{personGuid}/face/imageUrl,method:POST
  • 发送人员编号、照片、照片类型至云端,云端服务器存入该照片,生成一个照片guid并保存
  • 将照片与所属人员信息绑定,即保存人员-照片对应关系,在云端进行人员照片注册
  • 注册成功后会返回服务器分配的照片编号guid(简称照片id),照片所属人员id(personGuid)等
  • 若云端已存有设备-人员对应的授权关系,则新注册的照片将自动下发到授权设备上。若设备在线,则接收并存储照片;若设备离线,则联网后自动接收照片

为一个人员id(PersonGuid)注册一张新的照片,在云端添加(录入)该照片并存储人员-照片对应关系

  • 图片格式为jpg
  • 照片类型为普通RGB(静态图片)和红外(活体拍摄)
  • "code": "GS_SUS600",//人员照片注册接口调用成功,照片成功录入云端服务器,人员-照片关系绑定
要求
1.图片尺寸为640*480左右
2.图片中只有一个人脸
3.图片中人脸端正
4.图片中人脸占图片30%以上
5.图片大小不超过400K
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
guid 照片所属人的 id String Y
imageUrl 照片url(jpg格式) String Y
type 照片类型 Byte N 1:普通 RGB 照片,默认;
2:红外照片, 特定设备型号使用;
若传入type字段,则内容不可为空
useUFaceCloud 服务器端照片检测 Boolean N 传入false为不检测注册照片,传入true检测注册照片是否符合;若不传入useUFaceCloud字段,则默认检测照片的合法性
validLevel 校验等级 Int N 当useUFaceCloud设置为true时生效。
检测属性包含:人脸框大小、角度、越界、光照、模糊、阴阳脸。
默认为1
0:检测全部属性是否合格(RGB建议采用此标准);
1:仅检测人脸大小及角度(不建议采用);
2:在等级1基础上,附加人脸框越界 及 模糊度检测(红外照片质量检测建议采用此标准)
{
	"result": 1,
	"code": "GS_SUS600",//人员照片注册接口调用成功
	"msg": "success",
	"data": {
		"guid": "778B83E0C4814B648E976673DDDF9F62",//照片guid
		"userGuid": null,//客户guid
		"appId": "BEC39FBDF6D94E3798AFB19DDF056EE7",//应用id
		"personGuid": "0014C4A5931D4B05B1C0ED560EE21C9E",//人员guid
		"type": 1,//照片类型 1:RGB;2:红外
		"createTime": 1502764450138,//创建时间, 毫秒时间戳
		"faceUrl": http://file.ground-images-release.uni-ubi.com/0680C82203F74D52ADB279829C25BEB8/DE81002A40A94222AFBE4477F3DD4F2B/2C2AFBD3630E446DACFC86E6BD86783A//注册照url
	},
	"success": true
}