ecologyDoc/AI/人脸库接入文档.md

注意事项

1. 以下接口请求头必须加入Authorization，值为授权token(如何获取token)
2. 接口数据格式 Json

人脸特征注册

经过身份核查的人脸信息登记接口，为身份核查提供人脸库基础数据
请求方式 POST http://172.20.109.105:7007/tech/ai/face/faceLib/person/reg

请求参数		类型	是否必填	说明
async		boolean	否	是否开启异步反馈模式，默认为false
extData			否	附加参数登记，详见接口调用附加信息登记
idNum		String	是	身份证号
name		String	是	姓名
personType		String	是	人员类型，normal-普通客户 vip-高级客户 inner-内部员工
faceImage		-	-	注册人脸库生活照
	origin	String	否	image的数据类型。 base64字符串：self (base64内容需在400k以内) 来自文件服务器：fds （带压缩效果，推荐使用，详见fds使用文档） 图片链接：uri 默认为 self
	data	String	是	图片数据（base64，文件服务器文件路径或链接）

返回参数			类型	是否必返	说明
errcode			Num	是	0交易成功 其它为异常情况
errmsg			String	否	errcode不为0时有值
data			-	-	包含数据见下
	status		String	是	“SUCCESS”为业务成功
	traceNo		String	是	当前业务的唯一id
	result		String	是	业务结果
		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使用文档） 图片链接：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"
}