人脸注册接口
2025.02.17 20:09:13
使用人脸检索业务前,需要注册人脸照片,注册后的人脸就是会进行检索的人脸库,简而言之就是往人脸库中导入人脸照片
接口说明
鉴权说明
易盾信息认证服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://verify.dun.163.com/v1/facerecg/addFace |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由请求公共参数和请求业务参数两部分组成,通用参数见请求通用字段
名称 | 类 型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
name | String | 是 | 64 | 用户真实姓名,以身份证上姓名为准 |
faceId | String | 是 | 64 | 人员id,不同人员不可重复 |
picType | String | 是 | 4 | 图片类型:1-URL,2-BASE64 |
avatar | String | 是 | 1024或10M | 头像照片,URL不可超过1024,BASE64不可超过10M |
请求体示例
name=张三&faceId=323311889&avatar=xxx&picType=1&version=v1&businessId=xxx×tamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段
名称 | 类 型 | 必须返回 | 描述 |
---|---|---|---|
status | Number | 是 | 注册结果,1-添加成功 2-添加失败 3-重复添加 4-图片下载失败,请重试 5-上传图片质量过低,无法解析到完整的人脸。 |
响应体示例
{
"code":200,
"msg":"ok",
"result":{
"status":1
}
}
响应返回码
响应返回码见:响应返回码