删除人脸
删除人脸库中人脸,可以根据人脸ID字段删除,也可以根据用户自定义字段精准匹配删除。根据用户自定义字段删除可能会同时删除多张人脸数据,请谨慎操作
接口调用说明
请求地址 : /v1/api/frs/face/delete
请求方式 : POST
请求头
参数名 | 参数值 | 是否必须 |
---|---|---|
Content-Type | application/json | 是 |
X-Token | 实际accessToken | 是 |
请求报文体
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
colName | String | 是 | 人脸库名称,限制[3,32]个字符 |
faceId | Integer[] | 否 | 人脸ID |
imgId | String | 否 | 用户指定的图片外部ID |
extraFieldA | String | 否 | 用户自定义字段A |
extraFieldB | String | 否 | 用户自定义字段B |
可根据faceId
或者imgId,extraFieldA,extraFieldB
三个字段进行人脸的删除,二选一即可。即faceId
存在的情况下不会使用其他任何参数。
imgId,extraFieldA,extraFieldB
,这3个参数均为可选参数,用户可根据实际使用情况传参,如果都传的情况下,只会删除同时满足3个条件的数据,有一项不满足则不会删除。
示例数据
HTTP/1.1 200 OK
Content-Type:application/json
X-Token: eyJ0eXAiOiJKV1Q.***.hkdsfiYHFDJKDFQPEO
{
"colName":"face",
"faceId":[452020200773119130],
"imgId":"15768ce8f88a45b59c187665c16180fa",
"extraFieldA": "",
"extraFieldB": ""
}
响应报文
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
code | Integer | 是 | 状态码 |
msg | String | 是 | 状态码解释信息 |
data | Object | 否 | 返回内容 |
示例数据
HTTP/1.1 200 OK
Content-Type:application/json
{
"code":1000,
"msg":"success",
"data":{}
}