更新人脸 - UpdateFace
功能介绍
根据人脸ID（face_id）更新单张人脸信息。
前提条件：
application/json请求的body中，请使用标准Json格式。
URI
PUT /v2/{project_id}/face-sets/{face_set_name}/faces
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 |
| face_set_name | String | 是 | 人脸库名称。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，响应消息头中X-Subject-Token的值即为Token。 |
| Content-Type | 是 | String | 发送的实体的MIME类型，参数值为“application/json”。 |
| 参数名 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|
| face_id | String | 是 | 人脸ID，由系统内部生成的唯一ID。 |
| external_image_id | String | 否 | 用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。 这里是待修改的参数，external_image_id和external_fields至少选一个。 |
| external_fields | Object | 否 | 自定义字段的key值长度范围为[1,36]，string类型的value长度范围为[1,256]，具体参见自定义字段。 这里是待修改的参数，external_image_id和external_fields至少选一个。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| face_number | Integer | 更新的人脸数量。 调用失败时无此字段。 |
| face_set_id | String | 人脸库ID。 调用失败时无此字段。 |
| face_set_name | String | 人脸库名称。 调用失败时无此字段。 |
状态码： 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 调用失败时的错误码。 调用成功时无此字段。 |
| error_msg | String | 调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
X-Auth-Token值获取方法请参见认证鉴权。
- 请求样例
PUT https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT... Request Body: { "face_id": "iexEBb6t", "external_image_id": "imageID", "external_fields": { "timestamp": 12, "id": "300018629384756" } }
响应示例
状态码：200
{
"face_number": 1,
"face_set_id": "T785tx1N",
"face_set_name": "showFaceSet"
} 状态码：400
{
"error_code": "FRS.0303",
"error_msg": "The face id is not exist, checkout your input."
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
