### 注意事项 1. 以下接口请求头必须加入`Authorization`,值为授权token([如何获取token](../core/Token使用文档.md)) 2. 接口数据格式 `Json` ### 人脸特征注册 > 经过身份核查的人脸信息登记接口,为身份核查提供人脸库基础数据
> 请求方式 ` POST http://172.20.109.105:7007/tech/ai/face/faceLib/person/reg`
| 请求参数 || 类型 | 是否必填 | 说明 | | --- | --- |--- | --- | --- | | async || boolean| 否 | 是否开启异步反馈模式,默认为false | | idNum || String| 是 | 身份证号 | | name || String| 是 | 姓名 | | personType || String| 是 | 人员类型,normal-普通客户 vip-高级客户 inner-内部员工 | | faceImage || -| - | 注册人脸库生活照 | || origin | String| 否 | image的数据类型。
base64字符串:self (**base64内容需在400k以内**)
来自文件服务器:fds (**带压缩效果,推荐使用,详见[fds使用文档](../file/文件服务器接口.md))**
图片链接:uri
默认为 self | || data | String| 是 | 图片数据(base64,文件服务器文件路径或链接) | | 返回参数 || | 类型 | 是否必返 | 说明 | | --- | --- | --- |--- | --- | --- | | errcode ||| Num| 是 | 0交易成功
其它为异常情况 | | errmsg ||| String | 否 | errcode不为0时有值 | | data| || - | - | 包含数据见下 | | |ok || String | 是 | true:注册成功
false:注册失败 | 请求示例 ``` { "personType": "vip", "idNum": "610xxxxxxxxxxxx019", "name": "张三", "customerID": "", "faceImage": { "type": "image", "origin": "fds", "data": "xxxxxxxxxxxxxx.jpg" }, "async": false } ``` 返回示例 ``` { "errcode":0, "data":{ "ok":"true", }, "errmsg":"SUCCESS" } ``` ### 人脸库检索 > 传入人脸照片获取人员在人脸库中的信息及对比相似度
> 请求方式 ` POST http://172.20.109.105:7007/tech/ai/face/faceLib/person/recong` | 请求参数 || 类型 | 是否必填 | 说明 | | --- | ---| --- | --- | --- | | async || boolean| 否 | 是否开启异步反馈模式,默认为false | | faceImage || -| - | 注册人脸库生活照 | || origin | String| 否 | image的数据类型。
base64字符串:self (**base64内容需在400k以内**)
来自文件服务器:fds (**带压缩效果,推荐使用,详见[fds使用文档](../file/文件服务器接口.md))**
图片链接:uri
默认为 self | || data | String| 是 | 图片数据(base64,文件服务器文件路径或链接) | | 返回参数 || | 类型 | 是否必返 | 说明 | | --- | --- | --- |--- | --- | --- | | errcode ||| Num| 是 | 0交易成功
其它为异常情况 | | errmsg ||| String | 否 | errcode不为0时有值 | | data| || - | - | 包含数据见下 | | |status || String | 是 | “SUCCESS”为业务成功 | | |traceNo || String | 是 | 当前业务的唯一id | | |result|| String | 是 | 业务结果 | | ||idNum | String| 否 | 身份证号,match为true返回 | | ||customerID | String| 否 | 客户号,match为true返回 | | ||name | String| 否 | 姓名,match为true返回 | | ||personType | String| 否 | 人员类型,match为true返回,normal-普通客户 vip-高级客户 inner-内部员工 | | ||match | String | 否 | true:匹配成功
false:匹配失败 | | ||score | String | 否 | 匹配分数,验证通过时返回,推荐达到70时可判断为同一人(70的误通过率为千分之一,80的误通过率是万分之一,根据具体场景自行调整阈值)| 请求示例 ``` { "async":false, "faceImage":{ "type": "image", "origin": "fds", "data": "xxxxxxxxxxxxxx.jpg" } } ``` 返回示例 ``` { "errcode":0, "data":{ "idNum":"610xxxxxxxxxxxx019", "customerID":"", "name":"张三", "personType":"vip", "isMatch":"true", "score":"80", }, "errmsg":"SUCCESS" } ```