登录
智慧硬件开发 硬件云端接入 考勤/门禁设备 接口调用 上报成员识别信息变化结果
上报成员识别信息变化结果
最后更新：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_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 | 错误码描述 |
服务商可能存在不同版本计算人脸/指纹的算法，企业微信云端不做感知，只要上报一次信息某个企业成员识别录入成功，那么这个成员在本企业已经绑定的同一个服务商不同的考勤机，同一个服务商机型不同计算人脸/指纹算法版本，以及未来可能绑定的同一个服务商的考勤机，都将视为已经录入状态，因此这里服务商要特别注意做好兼容。
- 上报成员识别信息变化结果
本节内容
