调用deleteFaces接口删除人脸图片。

请求语法

POST /green/sface/face/delete HTTPS|HTTP

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求头。

请求参数

名称 类型 是否必选 示例值 描述
clientInfo JSONObject 否 {"userId":"120234234","userNick":"Mike","userType":"others"} 客户端信息，由ClientInfo结构体通过JSON序列化获得，包含umid、imei等信息，具体结构描述，请参见ClientInfo。

RequestBody

RequestBody中还需要填入以下参数，用来指定要删除的人脸图片信息。

名称 类型 是否必选 示例值 描述
personId String 是 person1 人脸图片关联的个体ID。
faceIds StringArray 是 ["1244453323565","1345345466455"] 要删除的人脸图片ID列表。
说明 您可以调用getPersonInfo接口查询个体关联的人脸图片ID。

返回数据

所有请求均返回JSON格式的数据。关于返回数据中的公共字段，请参见公共返回参数。返回数据中的data字段表示与业务相关的数据，一般是一个JSON结构体或数组。
说明 响应出错的情况下，data字段可能为空。

该接口返回的data字段包含以下参数。

名称 类型 示例值 描述
code Integer 是 错误码，和HTTP状态码一致。

更多信息，请参见公共错误码。

personId String 是 个体ID。
faceIds StringArray 是 成功删除的人脸图片ID列表。
deleteCount Integer 是 成功删除的人脸图片数目。

示例

请求示例
POST /green/sface/face/delete HTTP/1.1
公共请求头
{
    "personId": "person1",
    "faceIds": [
        "1244453323565",
        "1345345466455"
    ]
}
正常返回示例
{
    "msg": "OK",
    "code": 200,
    "requestId": "36D384DA-8023-4E84-BCFD-0C5581352C16",
    "data": {
        "code": 200,
        "personId": "person1",
        "faceIds": [
            "1244453323565",
            "1345345466455"
        ],
        "deleteCount": 2
    }
}

错误码

访问错误中心查看更多错误码。