智慧硬件开发
智慧硬件开发
硬件云端接入
考勤/门禁设备
接口调用
上报成员识别信息变化结果
上报成员识别信息变化结果
最后更新:2024/02/01

当用户从企业微信端发起录入指纹或人脸事件时,企业微信服务端触发一条回调指令识别信息录入事件。当录入事件完成后,厂商云端通过此接口,将录入结果上报至企业微信服务端。

 

请求方式: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_tokenstringdevice_access_token ,获取方式见获取设备调用凭证
oper_idstring识别信息录入事件的操作id,企业微信客户端发起录入指纹或人脸事件,企业微信给厂商的回调中会携带操作id。如果oper_id字段存在则忽略open_userid、user_type、bio_info_type字段
errcodeuint32识别信息录入事件的操作结果:0-录入成功;1-设备离线;其他失败-厂商自定义
errmsgstring识别信息录入事件的操作结果描述,如:设备离线,找不到人脸等
open_useridstring录入成员的open_userid,oper_id不存在或者为空时生效
user_typeuint32成员类型,0 企业成员,2 家校学生,oper_id不存在或者为空时生效
bio_info_typeuint32上报生物信息结果类型,1 指纹,2 人脸,oper_id不存在或者为空时生效

返回结果:

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

参数说明:

参数名描述
errcode错误码
errmsg错误码描述
服务商可能存在不同版本计算人脸/指纹的算法,企业微信云端不做感知,只要上报一次信息某个企业成员识别录入成功,那么这个成员在本企业已经绑定的同一个服务商不同的考勤机,同一个服务商机型不同计算人脸/指纹算法版本,以及未来可能绑定的同一个服务商的考勤机,都将视为已经录入状态,因此这里服务商要特别注意做好兼容。
上一篇上报门禁通行记录
下一篇上报远程开门结果
    本节内容
硬件直连接入
更新日志
联系我们