企业可通过自建应用,为企业打卡人员录入人脸信息,人脸信息仅用于人脸打卡。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/checkin/addcheckinuserface?access_token=ACCESS_TOKEN
请求示例
{
"userid": "james",
"userface": "PLACE_HOLDER"
}
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | 调用接口凭证,获取方式参考:文档-获取access_token |
userid | 否 | string | 需要录入的用户id |
userface | 否 | string | 需要录入的人脸图片数据,需要将图片数据base64处理后填入,对已录入的人脸会进行更新处理 |
注意:对于已有人脸的用户,使用此接口将使用传入的人脸覆盖原有人脸,请谨慎操作。
权限说明:
调用的应用需要满足如下的权限:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「打卡 - 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
调用频率:
接口调用频率限制为10次/分钟。
返回结果:
{
"errcode": 0,
"errmsg": "ok"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 错误码描述 |
错误说明:
错误码 | 说明 |
---|---|
301021 | 输入参数错误 |
301069 | 输入userid无对应成员 |
301070 | 系统错误,请稍后再试 |
301071 | 企业内有其他人员有相似人脸,此情况下人脸仍然会录入成功 |
301072 | 人脸图像数据错误请更换图片 |
上传图片大小限制:
图片数据不超过1M