接口描述：

在核验用户身份信息的同时、确保当前操作人为本人。可应用于远程开户、在线教育、刷脸支付等场景。通过用户的身份证号、姓名和自拍照去第三方进行身份验证，通过返回分数判断是否为同一个人。

使用场景：

酒店、机场、高铁、火车站这种人流聚集地，用于安保防范。

物流行业会要求对司机/货主进行身份核验。确保运输安全。

游戏、直播平台需要进行身份核验，用于防沉迷系统等。

金融保险行业也需要进行身份核验，用于风控场景，减少欺诈行为。

疫情防控，大家做核酸，出示健康码的时候都需要进行身份核验。

接口说明：

入参：姓名+身份证号+人脸照

接口方法：

https://api.cxlnk.com/api/identityVerify/faceThree

接口协议：

HTTP POST

报头定义：

编码	列表	内容	备注
1	Accept	application/json
2	Content-Type	application/json;charset=utf-8

请求参数列表:

编码	列表	内容	备注
1	accessKey	API调用账号（必填，从灿星云平台获取）
2	accessSecret	API调用密钥（必填，从灿星云平台获取）
3	idNo	身份证号码（必填）
4	name	姓名（必填）
5	image	人脸照，base64字符串（必填），base64字符串去掉头部描述(如data:image/png;base64)	注：当您在进⾏实人认证的时候，请传入满足以下所有条件的图片： 认证主体的近期照片，人脸需要完整清晰无遮挡、表情自然且正对摄像头。 照片清晰、曝光正常，脸部无过黑、过亮、光晕等情况、角度无太大偏差。 分辨率不超过1920*1080（高*宽），至少640*480，推荐短边缩放到720像素，压缩率大于0.9。照片高大于宽，如果传入的照片宽大于高，可能会影响检测效果。 支持照片格式为jpg、jpeg、png，照片大小需小于1MB

请求参数示例：

• {
• "accessKey":"87d0373b**********",
• "accessSecret":"b20d7c5e1c********************",
• "idNo":"341225****",
• "name":"李明",
• "image":"DAQL/xAA+EAACAgEEAAUCAwYD***************"
• }

响应参数列表：

编码	列表	内容	备注
1	code	状态码200则为成功
2	msg	状态说明
3	success	处理是否成功:取值范围true，false
4	data	业务数据如果失败则为空
5	result	结果描述
6	code	说明： -1：接口异常或超时 -2：参数错误 -3：无效的外部订单号 -4：无效图像尺寸、大小 -5：图像解析失败 -6：内部错误，请联系供应商 1：认证通过 2：人像比对非同一人 3：人像疑似 4：上传图片大小、格式、质量不合格或不可用 5：身份信息无效 6：数据库中无该人信息 9：其他错误
7	fee	是否扣费0不收费1收费
8	reqNo	请求唯一标识
9	photoScore	比对分 photoScore大于或等于60确认为同一人；40小于或等于photoScore小于60不确定为同一人；photoScore小于40确定为不同人

响应参数示例：

• {
• "code": 200,
• "msg":"认证通过",
• "success":true,
• "data":{
• "result": "OK",
• "code": 1,
• "fee": 1,
• "reqNo": "37fc53a6238c4806845943f726***",
• "photoScore": "99.95"
• }
• }

Result返回说明：

Result返回说明	描述
OK	认证通过
NOT_SAME_PERSON	身份信息无效
NOT_EXIST_ERROR	接口异常或超时
INVALID_PARAM	参数错误
INITIALIZE_INVALID_OUTORDERNO	无效的外部订单号
ILLEGAL_IMAGE_SIZE	无效图像尺寸、大小
FETCH_IMAGE_FAIL	图像解析失败

结果码说明：

结果码	描述
200	成功
500，501，503	系统错误
502	系统繁忙
60021	余额不足，请充值后重试！
10000	内部系统出错，请联系厂商