录入打卡人员人脸信息

POST

/cgi-bin/checkin/addcheckinuserface

服务端API企业内部开发

企业可通过打卡应用Secret调用本接口，为企业打卡人员录入人脸信息，人脸信息仅用于人脸打卡。

注意：对于已有人脸的用户，使用此接口将使用传入的人脸覆盖原有人脸，请谨慎操作。

权限说明: (无特殊权限)

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

错误说明:

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

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

文档ID: 25718
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93378

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/checkin/addcheckinuserface?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"userid":"james","userface":"PLACE_HOLDER"}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

userid

string

需要录入的用户id

可选

userface

string

可选

需要录入的人脸图片数据，需要将图片数据base64处理后填入，对已录入的人脸会进行更新处理

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

修改于 2022-01-14 04:25:43

为打卡人员排班