当用户从企业微信端发起录入指纹或人脸事件时,企业微信服务端触发一条回调指令识别信息录入事件。当录入事件完成后,厂商云端通过此接口,将录入结果上报至企业微信服务端。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_bio_info_result?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:
{
"oper_id":"OPER_ID",
"errcode":1,
"errmsg":"设备离线",
"open_userid":"xxx",
"user_type":0,
"bio_info_type":1
}
参数说明:
参数名 | 是否必须 | 类型 | 描述 |
---|---|---|---|
device_access_token | 是 | string | device_access_token ,获取方式见获取设备调用凭证 |
oper_id | 否 | string | 识别信息录入事件的操作id,企业微信客户端发起录入指纹或人脸事件,企业微信给厂商的回调中会携带操作id。如果oper_id字段存在则忽略open_userid、user_type、bio_info_type字段 |
errcode | 是 | uint32 | 识别信息录入事件的操作结果:0-录入成功;1-设备离线;其他失败-厂商自定义 |
errmsg | 否 | string | 识别信息录入事件的操作结果描述,如:设备离线,找不到人脸等 |
open_userid | 否 | string | 录入成员的open_userid,oper_id不存在或者为空时生效 |
user_type | 否 | uint32 | 成员类型,0 企业成员,2 家校学生,oper_id不存在或者为空时生效 |
bio_info_type | 否 | uint32 | 上报生物信息结果类型,1 指纹,2 人脸,oper_id不存在或者为空时生效 |
返回结果:
{
"errcode": 0,
"errmsg": "ok"
}
参数说明:
参数名 | 描述 |
---|---|
errcode | 错误码 |
errmsg | 错误码描述 |
服务商可能存在不同版本计算人脸/指纹的算法,企业微信云端不做感知,只要上报一次信息某个企业成员识别录入成功,那么这个成员在本企业已经绑定的同一个服务商不同的考勤机,同一个服务商机型不同计算人脸/指纹算法版本,以及未来可能绑定的同一个服务商的考勤机,都将视为已经录入状态,因此这里服务商要特别注意做好兼容。