接口描述：

在移动端的H5页面中调用，通过在独立页面完成实人认证

使用场景：

Web系统：登录指定的网页，办理业务，在需要用户实人认证的环节中，显示二维码（跳转至H5引导页，完成转场），用户通过移动应用扫码后，开启支付宝APP完成实人认证。

移动应用：登录移动端办理业务，在需要用户实人认证的环节中，开启支付宝APP完成实人认证

接口说明：

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

接口方法：

https://api.cxlnk.com/api/safFace/faceH5Certification

接口协议：

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	returnUrl	认证成功后重定向地址（必填，需要加上协议头）

请求参数示例：

• {
• "accessKey":"87d0373b**********",
• "accessSecret":"b20d7c5e1c********************",
• "idNo":"341225****",
• "name":"李明",
• "returnUrl": "https://www.*.com"
• }

响应参数列表：

编码	列表	内容	备注
1	code	状态码200则为成功
2	msg	状态说明
3	success	处理是否成功:取值范围true，false
4	data	业务数据如果失败则为空
5	certifyId	流水号id用于获取人脸识别结果的表示
6	reqNo	业务唯一标识

响应参数示例：

• {
• "code": 200,
• "msg":"认证通过",
• "success":true,
• "data":{
• "certifyUrl": "https://ur.alip*******",
• "certifyId": "a*****",
• "reqNo": "A1****"
• }
• }

结果码说明：

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

获取权威版人脸识别结果（接口协议）：

HTTP GET

接口方法：

https://api.cxlnk.com/api/safFace/faceH5CertificationResult

报头定义：

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

请求参数列表:

编码	列表	内容	备注
1	accessKey	API调用账号（必填，从灿星云平台获取）
2	accessSecret	API调用密钥（必填，从灿星云平台获取）
3	certifyId	流水号,请求人脸识别接口返回消息体的certifyId

请求参数示例：

• {
• "accessKey":"87d0373b**********",
• "accessSecret":"b20d7c5e1c********************",
• "certifyId":"a123*****"
• }

响应参数列表：

编码	列表	内容	备注
1	code	状态码200则为成功
2	msg	状态说明
3	success	处理是否成功:取值范围true，false
4	data	业务数据如果失败则为空
5	materialInfo	信息
6	samePerson	人脸比对结果 -true（T） 同一人 -false （F）不同人
7	riskInterceptionType	人脸比对结果 -LIVENESS_NOT_PASS 基础活体拦截 -STRATEGY_NOT_PASS 组合策略拦截 -NONE 未拦截 -UNKNOWN 未知原因
8	scoreNormalized	0-100分，分数越高相似度越高，请联系您的客户经理获取阈值
9	attributes	人脸性别年龄预估
10	gender	性别 -male 男性 -female 女性
11	age	年龄
12	faceAttack	是否是攻击 -true 是攻击 -false 不是攻击
13	faceOcclusion	面部是否遮挡 -true 存在遮挡 -false 没有遮挡或仅有小部分遮挡
14	h5DegradeFlag	WEB降级标 -true 有降级 -false 没有降级
15	quality	综合质量分 0-100分，分数越高质量越好，请联系您的客户经理获取阈值
16	fee	是否收费：0不收费，1收费
17	passed	认证是否通过 -true（T） 通过 -false （F）未通过

响应参数示例：

• {
• "code": 0,
• "msg":"操作成功",
• "success":true,
• "data":{
• "materialInfo": {
• "samePerson": "F",
• "riskInterceptionType": "NONE",
• "scoreNormalized": "54.341607639293",
• "attributes": {
• "gender": "male",
• "age": 49
• },
• "faceAttack": false,
• "faceOcclusion": false,
• "h5DegradeFlag": "false",
• "quality": 100.0
• },
• "fee": 1,
• "passed": "F"
• }
• }

结果码说明：

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