上传识别特征值 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

智慧硬件开发

快速入门硬件直连接入硬件云端接入更新日志联系我们

智慧硬件开发硬件直连接入考勤/门禁设备接口调用上传识别特征值

上传识别特征值

最后更新：2023/08/30

用户录入指纹或人脸信息后，将信息同步至云端。最多200人。

请求包体：

{
    "cmd":"upload_userinfo",
    "headers":{
        "req_id":"xxxxx"
    },
    "body":{
        "oper_id":"xxxx",
        "errcode":0,
        "errmsg":"ok",
        "userinfo":[
            {
                "userid":"x1",
                "user_type":0,
                "fp":[
                    {
                        "id":0,
                        "data":"xxxx"
                    },
                    {
                        "id":1,
                        "data":"xxxx"
                    }
                ],
                "fp_algorithm":"xxx1",
                "fa_list":[
                    {
                        "id":0,
                        "data":"xxxx"
                    },
                    {
                        "id":1,
                        "data":"xxxx"
                    }
                ],
                "fa_algorithm":"xxxx1"
            },
            {
                "userid":"x2",
                "fa_list":[
                    {
                        "id":0,
                        "data":"xxxx"
                    },
                    {
                        "id":1,
                        "data":"xxxx"
                    }
                ],
                "fa_algorithm":"xxxx1",
                "user_type":1
            },
            {
                "userid":"x3",
                "fa":"xxxx"
            }
        ]
    }
}

参数说明：

参数名	是否必须	类型	描述
req_id	是	string	请求的id，自行保证不会重复即可
userid	是	string	成员id（字符串），长度为1-128个字节。当为访客userid时，参见访客userid规则说明
user_type	否	Uint32	成员的类型： 0：企业员工 1：访客 2：学生不填则默认值为0
fa	否	string	人脸特征值base64编码，可不填, 该字段只对企业员工进行兼容，访客请使用fa_list
fa_list	否	Array(object)	人脸特征值列表，当fa_list存在时，忽略fa的值
fa_list: id	否	string	人脸特征值编号，支持0-11，共12个人脸数据
fa_list：data	否	string	人脸特征值base64编码，可不填
fa_algorithm	否	string	上报的人脸特征值对应的算法版本，如果填写default，则使用的算法版本等同于考勤机订阅时上报指纹算法为空时使用的特征值数据
fp	否	Array(object)	指纹特征值
fp: id	否	string	指纹特征值编号，支持0-9，共十个指纹
fp：data	否	string	指纹特征值(base64)
fp_algorithm	否	string	上报的指纹特征值对应的算法版本，如果填写default 等同于不填写这个字段，即使用的算法版本等同于考勤机订阅时上报人脸算法为空时使用的特征值数据
oper_id	否	String	录入指纹的操作id，由3.2 （进入录入信息）或者3.7（推送成员录制人脸事件）下发下去。
errcode	否	int32	本次操作的返回值，0表示录入成功，非0表示失败，非0的具体错误码可以机器自行定义。
errmsg	否	string	本次操作的结果描述，如果录入成功请填写”ok”。其他errmsg可以机器自行定义。录入失败时，返回的errmsg将在企业微信录入流程中显示给用户。

注：oper_id，errcode，errmsg这三个参数填写时机为：在操作界面录入单个成员指纹1min内调用upload_userinfo接口。如果设备断网，后续网络恢复后的补推可以不填写，用户自行在考勤机录入信息的，不用填写operid。

访客或者企业内成员通过企业微信app录制也需要传回oper_id，页面会根据回传的errcode和errmsg展示录制结果。

企业微信允许第三方应用设置访客人脸。此处建议设备访客的信息补推一律都不要合并，且尽量带上oper_id，errcode，errmsg，方便企业微信通知第三方应用每个访客的录制结果。

fa_list fp字段中，数据必须为不可逆推的特征值，不可上传人脸或指纹原图。

返回结果：

{
	"headers": {
		"req_id" : "xxxx"
	},
	"body": {
		"fail_list" : [
			{
				"userid":"x1",
				"user_type":0
			},
			{
				"userid":"x3",
				"user_type":0
			}
		]
	},
	"errcode": 0,
	"errmsg": "ok"
}

参数说明：

参数名	描述
req_id	透传请求的req_id
user_type	成员的类型： 0：企业员工 1：访客 2：学生不填则默认值为0
errcode	错误码
errmsg	错误码描述
fail_list	上传失败的用户，返回值为userid

获取通讯录最新版本号

全量获取访客数据

本节内容

上传识别特征值