# 描述

此接口提供从指定人脸库删除特征值的功能。

调用URL：

https://api-sgp.yljz.com/finauth/search/group/delete

# 请求参数

是否必选	参数名	类型	参数说明
必选	sign	String	调用此API客户的签名，具体的签名产生方式请查阅”鉴权说明“文档
必选	sign_version	String	签名算法版本，请传递：hmac_sha1
必选	group_id	String	用户自定义的人脸库标识
必选	face_tokens	String	需要移除的人脸标识字符串，可以是一个或者多个face_token组成，用逗号分隔。最多不能超过1000个face_token

# 返回值说明

字段	类型	说明
request_id	String	用于区分每一次请求的唯一的字符串。除非发生404（API_NOT_FOUND ) 或403 （AUTHORIZATION_ERROR）错误，此字段必定返回。
group_id	String	用户自定义的人脸库标识
face_removed	Int	成功从人脸库中移除的face_token数量
face_count	Int	操作完成后人脸库中的face_token数量
failure_detail	Array	无法从人脸库中移除的face_token以及原因 face_token：人脸标识 reason：不能被移除的原因，包括 FACE_NOT_IN_GROUP
time_used	Int	整个请求所花费的时间，单位为毫秒。除非发生404（API_NOT_FOUND )或403 （AUTHORIZATION_ERROR）错误，此字段必定返回。
error	String	当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。

返回值示例

正确请求返回示例

{
    "request_id": "1769740387,ba578f31-c5e9-4048-8290-2627686f97fe",
    "time_used": 101,
    "group_id": "YuanliStudent_01",
    "face_removed": 1,
    "face_count": 1,
    "failure_detail": [
        {
            "face_token": "34dce3f2d1fc4736670b4bad58523ce8",
            "reason": "FACE_NOT_IN_GROUP"
        }
    ]
}

错误返回示例

{
    "request_id": "1769684828,e483ae63-913b-4e32-9068-3719cce59570",
    "time_used": 15,
    "error": "INVALID_FACE_TOKENS_SIZE"
}

# error_message错误信息

当前API特有的ERROR_MESSAGE

HTTP状态代码	错误信息	说明
400	INVALID_OUTER_ID	人脸库不存在
400	INVALID_FACE_TOKENS_SIZE	face_tokens数组长度不符合要求