企业内部开发 服务端API 打卡 录入打卡人员人脸信息
录入打卡人员人脸信息
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
录入打卡人员人脸信息
最后更新:2023/11/30

企业可通过自建应用,为企业打卡人员录入人脸信息,人脸信息仅用于人脸打卡。

 

请求方式:POST(HTTPS)

请求地址:https://qyapi.weixin.qq.com/cgi-bin/checkin/addcheckinuserface?access_token=ACCESS_TOKEN

请求示例

{
    "userid": "james",
    "userface": "PLACE_HOLDER"
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证,获取方式参考:文档-获取access_token
useridstring需要录入的用户id
userfacestring需要录入的人脸图片数据,需要将图片数据base64处理后填入,对已录入的人脸会进行更新处理
注意:对于已有人脸的用户,使用此接口将使用传入的人脸覆盖原有人脸,请谨慎操作。

 

权限说明:
调用的应用需要满足如下的权限:

应用类型权限要求
自建应用配置到「打卡 - 可调用接口的应用」中
代开发应用暂不支持
第三方应用暂不支持

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

调用频率:
接口调用频率限制为10次/分钟。

返回结果:

{
    "errcode": 0,
    "errmsg": "ok"
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述

错误说明:

错误码说明
301021输入参数错误
301069输入userid无对应成员
301070系统错误,请稍后再试
301071企业内有其他人员有相似人脸,此情况下人脸仍然会录入成功
301072人脸图像数据错误请更换图片

上传图片大小限制:
图片数据不超过1M

上一篇
添加打卡记录
下一篇
获取设备打卡数据