ecologyDoc/AI/腾讯人脸增强版接口.md

注意事项

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

合作方后台上传身份信息

合作方后台上传身份信息，活体+比对需传入自带源照片；活体+核身需传入姓名、身份证号
请求方式 POST http://172.20.109.105:7007/tech/ai/face/faceAdv

请求参数		类型	是否必填	说明
async		boolean	否	是否开启异步反馈模式，默认为false
extData			否	附加参数登记，详见接口调用附加信息登记
userId		String	是	用户ID ，用户的唯一标识（不能带有特殊字符)。 同一个用户的 userId 请保持一致，不同用户请不要使用同一个userId
type		String	是	活体+自带源比对传入 match 活体+权威源比对传入 authmatch
sourcePhotoStr		-	-	活体+自带源比对时必须传入
	origin	String	否	sourcePhotoStr的数据类型。 base64字符串：self (base64内容需在400k以内) 来自文件服务器：fds （带压缩效果，推荐使用，详见fds使用文档） 图片链接：uri 默认为 self
	data	String	是	图片数据（base64，文件服务器文件路径或链接）
name		String	否	姓名，活体+权威源比对时必须传入
idNo		String	否	身份证号，活体+权威源比对时必须传入

返回参数			类型	是否必返	说明
errcode			Num	是	0交易成功 其它为异常情况
errmsg			String	否	errcode不为0时有值
data			-	-	包含数据见下
	status		String	是	“SUCCESS”为业务成功
	traceNo		String	是	当前业务的唯一id
	result		String	是	业务结果
		bizSeqNo	String	否	业务流水号
		orderNo	String	否	订单编号
		faceId	String	否	此次刷脸用户标识，调 SDK 时传入
		sign	String	否	签名
		nonce	String	否	随机数
		appId	String	否	业务流程唯一标识，即 WBappid

请求示例

{
     "async":false,
     "userId":"user123",
     "type":"match",
     "sourcePhotoStr":{
         "origin":"fds",
         "data":"xxxxxxxxxxxxxx.jpg"
     }
}

返回示例

{
    "errcode":0,
    "data":{
        "status":"SUCCESS",
        "traceNo":"45646513218465123",
        "result":{
            "bizSeqNo":"业务流水号"，
            "orderNo":"合作方订单号", 
            "faceId":"cc1184c3995c71a731357f9812aab988"
        }, 
    },
    "errmsg":"SUCCESS"
}

人脸核身结果查询

查询人脸核身结果
请求方式 POST http://172.20.109.105:7007/tech/ai/face/faceAdvResult

请求参数		类型	是否必填	说明
async		boolean	否	是否开启异步反馈模式，默认为false
extData			否	附加参数登记，详见接口调用附加信息登记
orderNo		String	是	订单编号
getFile		String	否	是否需要获取人脸识别的视频和文件，值为1则返回视频和照片、值为2则返回照片、值为3则返回视频；其他则不返回

返回参数			类型	是否必返	说明
errcode			Num	是	0交易成功 其它为异常情况
errmsg			String	否	errcode不为0时有值
data			-	-	包含数据见下
	status		String	是	“SUCCESS”为业务成功
	traceNo		String	是	当前业务的唯一id
	result		String	是	业务结果
		tencentCode	String	否	腾讯返回错误码
		tencentMsg	String	否	腾讯返回错误信息
		bizSeqNo	String	否	业务流水号
		transactionTime	String	否	请求接口的时间
		orderNo	String	否	订单编号
		liveRate	String	否	活体检测得分
		similarity	String	否	人脸比对得分
		occurredTime	String	否	进行刷脸的时间
		photo	String	否	人脸核身时的照片，base64 位编码
		video	String	否	人脸核身时的视频，base64 位编码
		sdkVersion	String	否	人脸核身时的 sdk 版本号
		trtcFlag	String	否	Trtc 渠道刷脸则标识”Y”
		appId	String	否	腾讯云控制台申请的 appid

请求示例

{
     "async":false,
     "orderNo":"订单编号",
     "getFile":"2"
}

返回示例

{
    "errcode":0,
    "data":{
        "status":"SUCCESS",
        "traceNo":"45646513218465123",
        "result":{
            "tencentCode":"0",
            "tencentMsg":"请求成功",
            "bizSeqNo":"22041520001184442415491408594474",
            "orderNo":"testReflect1650008613761",
            "occurredTime":"20220415154341",
            "liveRate":"99",
            "similarity":"97.0",
            "photo":"*",
            "video":"*"
        }, 
        

    },
    "errmsg":"SUCCESS"
}