上传人脸图片

PUT

/acs/v1/users/{user_id}/face

用户需要录入人脸图片才可以使用门禁考勤机。使用该 API 上传门禁用户的人脸图片。

错误码

HTTP状态码	错误码	描述	排查建议
400	1490101	user not found	检查用户是否加入权限组
400	1490108	user face crop fail	检查图片是否符合规范

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Query 参数

Body 参数multipart/form-data

返回响应

🔴500200 Success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PUT '/acs/v1/users/ou_7dab8a3d3cdcc9da365777c7ad535d62/face?user_id_type=open_id' \
--header 'Authorization: Bearer <token>' \
--form 'files=@""' \
--form 'file_type="jpg"' \
--form 'file_name="efeqz12f.jpg"'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

修改于 2025-10-21 08:32:20

修改用户部分信息

下载人脸图片

上传人脸图片

错误码#

请求参数

返回响应

错误码