基于虹软人脸识别微服务

生物智能识别服务开放接口（基于OAuth2.0）

完整文档

生物智能识别服务开放接口202000722v1.03.01.pdf
生物智能识别服务系统是一个将人脸识别、指纹识别、虹膜识别融合的混合生物特征识别微服务系统，服务除了具备独立功能，并以Oauth2.0协议方式对外提供接口对接。

快速集成案例

人脸抓拍机抓拍服务

gitee

Gitee

1服务核心功能

人脸识别私有化部署（也称为人脸识别本地化部署）提供人脸检测、人脸比对、人脸检索、活体检测等人脸识别基础能力，基于OAuth2.0对外提供接口服务，可以让使用者快速集成人脸识别能力，扩展自己的业务系统，节省了大量的研发和时间成本。

一、OAuth2.0协议

OAuth2.0协议作为用户资源的授权，提供了一个当前较为安全的、开放又简易的标准。
OAuth2.0定义了授权码模式（Authorization Code）、简化模式（Implicit）、用户名密码模式（Resource Owner Password Credentials）、客户端凭证模式（Client Credentials）四种授权模式。
这里对OAuth2.0仅做简单描述，详细技术内容请查看OAuth2.0相关内容。“生物智能识别服务”提供服务主要基于客户端凭证模式。
客户端凭证模式（Client Credentials）

步骤：
(1)客户端向授权服务器申请授权；
(2)授权服务器返回一个Access Token；
(3)用Access Token去访问资源服务器；
(4)资源服务器返回资源。
注：“生物智能识别服务”同时充当授权服务器（Token授权）及资源服务器（生物识别接口）。

二、开放接口

（一）BaseUrl&Token获取

1.BaseUrl即为服务访问地址，如本机部署，端口为8080，则BaseUrl=http://localhost:8080，以下所提及接口都以BaseUrl为基础，用Post请求方式进行接口访问。
2.Access Token获取
地址：BaseUrl+/oauth/token
请求参数：

返回内容：
{
“access_token”: “3ec707a7-faa1-4dd2-9891-d8d6609a2b56”, //token值以备后续调用
“token_type”: “bearer”,
“expires_in”: 3576, //有效时间，单位（秒）
“scope”: “face_client”
}
注：
参数中client_id、client_secret，请在应用后台菜单“应用接口→应用管理”添加应用，填写相对应的参数值

（二）人脸对比

1．人脸对比
地址：BaseUrl+/auth/face/toFaceCompare
说明：即对两个人脸图片进行相识度匹配，判断是否为同一个人。
请求参数：
返回内容：
{
“code”: “0000”,
“msg”: “调用成功”,
“success”: true,
“data”: {
“reqParam”: “1”,
“similarValue”: 90 //相识度最小为0 最大值为100，
}
}
2．人脸图片搜索
地址：BaseUrl+/auth/face/toFaceSearch
说明：通过人脸图片人脸库中。
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: “调用成功”,
“success”: true,
“data”: {
“result”: [ {
“faceInfoId”: 15,
“faceId”: “oxa2t5jrug5p”,
“name”: “郑伊健”,
“similarValue”: 100,
“faceFeature”: null
}],
“reqParam”: “1”
}
}

（三）人脸管理

1．人脸列表
地址：BaseUrl+/auth/face/getFaceInfoPage
说明：加载人脸库中的列表
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: null,
“success”: true,
“data”: null,
“total”: 2,
“items”: [
{
“faceInfoId”: 14,
“groupId”: 1,
“faceId”: “9yjxto4qwa1d”,
“name”: “韩风”,
“userType”: 0,
“faceFeature”: “”,
“disabled”: false,
“createTime”: “2020-03-06 16:46:44”,
“updateTime”: “2020-03-06 16:46:44”,
“base64Img”: “”,
“userInfo”: “”
},
{
“faceInfoId”: 15,
“groupId”: 1,
“faceId”: “oxa2t5jrug5p”,
“name”: “郑伊健”,
“userType”: 0,
“faceFeature”: “”,
“userInfo”: “”
}
]
}
注：faceId、faceInfoId都可以作为人脸唯一标识
2．人脸添加
地址：BaseUrl+/auth/face/saveFaceInfo
说明：添加人脸到服务人脸库中
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: “调用成功”,
“success”: true,
“data”: {
“groupId”: 1,
“faceId”: “wjlbt2nwb1qo”,
“faceInfoId”: 53
}
}
3．人脸加载
地址：BaseUrl+/auth/face/loadFaceInfo
说明：通过faceId或faceInfoId加载人脸信息
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: “调用成功”,
“success”: true,
“data”: {
“userInfo”: null,
“groupId”: 1,
“name”: “测试”,
“base64Img”: “data:image/jpg;base64,…”,
“faceId”: “eq0upqqjf9j4”,
“userType”: 1,
“faceInfoId”: 50
}
}

4．人脸修改
地址：BaseUrl+/auth/face/updateFaceInfo
说明：通过faceId或faceInfoId修改录入的人脸信息
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: “调用成功”,
“success”: true,
“data”: null
}
5．人脸删除
地址：BaseUrl+/auth/face/deleteFaceInfo
说明：通过faceId或faceInfoId删除人脸信息
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: “不存在的对象”,
“success”: false,
“data”: null
}

6．人脸检测
地址：BaseUrl+/auth/face/toFaceDetect
说明：对传入的图片进行人脸检测，并返回检测结果
请求参数：

返回内容：
{
“code”: “0000”,
“msg”: “调用成功”,
“success”: true,
“data”: {
“base64Img”: “data:image/jpg;base64,…”, //截取后的人脸头像
“reqParam”: null,
“faceRect”: {
“x”: 651,
“width”: 571,
“y”: 272,
“height”: 713
}
}
}

基于虹软人脸识别Web私有化服务（快速人脸服务集成二次开发）相关推荐

全面接入「人脸识别」，智慧城市公共服务的另一种思路
摘要:"人脸识别从线上到线下,应用在城市公共服务中的标准场景(信息查询.身份验证.安检安防等),所有这些"更智慧"的举措都指向了便民.利民.惠民化改造." 人脸 ...
基于Emgu CV+百度人脸识别，实现视频动态人脸抓取与识别
背景目前AI 处于风口浪尖,作为公司的CTO,也作为自己的技术专研,开始了AI之旅,在朋友圈中也咨询一些大牛对于AI 机器学习框架的看法,目前自己的研究方向主要开源的 AI 库,如:Emgu C ...
android虹软人脸识别简书,C# 离线人脸识别虹软ArcFace 2.0 demo
环境: win7以上 VS2013以上 sdk版本:ArcFace v2.0 x86 x64平台Debug.Release配置都已通过编译下载地址:https://github.com/Arcsof ...
基于百度云人脸识别API与opencv的人脸识别系统
基于百度云人脸识别API与opencv的人脸识别系统简介弄这个东西是因为参加了学校的项目,第一次开发做的不是很好. 本系统是基于百度云人脸识别API.opencv级联器.PYQT5进行开发.百度云 ...
Python+OpenCv实现AI人脸识别身份认证系统(2)——人脸数据采集、存储
原 Python+OpenCv实现AI人脸识别身份认证系统(2)--人脸数据采集.存储 2019年07月02日 08:47:52 不脱发的程序猿阅读数 602更多所属专栏: 人脸识别身份认证系统设 ...
应用层下的人脸识别（四）：人脸研判
作者根据多年人脸识别项目经验,总结了人脸识别技术在安防.商业领域应用及产品设计细节,汇总成应用层下的人脸识别系列文章.本文为系列文章的第四篇,从什么是人脸研判及人脸研判类型和应用两方面介绍相关内容. ...
c++ 人脸识别_应用层下的人脸识别（四）：人脸研判
作者根据多年人脸识别项目经验,总结了人脸识别技术在安防.商业领域应用及产品设计细节,汇总成应用层下的人脸识别系列文章.本文为系列文章的第四篇,从什么是人脸研判及人脸研判类型和应用两方面介绍相关内容. ...
python人脸识别框很小_人脸识别：从传统方法到深度学习
人脸识别:从传统方法到深度学习这开始于上世纪七十年代,人脸识别成为了计算机视觉领域和生物识别领域最具有研究型的话题之一.传统方法依赖于手工制作模型特征,通过深度神经网络训练大量的数据集的方法也在最近 ...
人脸识别最低像素_深入浅出人脸识别技术
在深度学习出现后,人脸识别技术才真正有了可用性.这是因为之前的机器学习技术中,难以从图片中取出合适的特征值.轮廓?颜色?眼睛?如此多的面孔,且随着年纪.光线.拍摄角度.气色.表情.化妆.佩饰挂件等等的 ...

基于虹软人脸识别Web私有化服务（快速人脸服务集成二次开发）