接口描述：

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

使用场景：

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

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

接口方法：

https://www.gzface.net/api/facet/createVerify

接口协议：

HTTP POST

请求参数列表:

编码	列表	内容	备注
1	appid	API APPID（必填，从平台获取）
2	data	加密后的请求数据	data参数需要通过RSA进行加密 RSA公钥从平台获取

data参数结构:

编码	列表	内容	备注
1	name	姓名
2	idcard	身份证
3	code	认证码，认证成功后会得到这个认证码

请求参数示例：

• {
• "appid":"1001",
• "data":"d66Iy5qKrP09bxY4ME5J2hHBJvu5Z5Q8LC********************"
• }

响应参数列表：

编码	列表	内容	备注
1	code	状态码1则为成功
2	msg	状态说明
3	time	当前时间戳
4	data	业务数据如果失败则为空
5	data.random_id	本次认证ID
6	facecheck	本次认证动作序列

响应参数示例：

• {
• "code": 1,
• "msg":"创建成功",
• "time":1740886304,
• "data":{
• "random_id":"80639f82b68d6d97b62f3002c8f9c4aa44*******",
• "facecheck":"请张嘴2次 点头1次"
• }
• }

结果码说明：

结果码	说明
1	成功
401	初始化时传入的参数不正确，请检查各个传参是否符合预期。
500，501，503	系统错误
502	系统繁忙
1001	余额不足，请充值后重试！
1002	内部系统出错，请联系厂商

视频人脸验证：

传入视频进行验证是否为本人

接口协议：

HTTP POST

接口方法：

https://facessl.gzface.net:7443/start_detection

请求参数列表:

编码	列表	内容	备注
1	video	视频文件
2	random_id	验证ID 通过创建认证接口获得

请求参数示例：

• {
• "video":FILE,
• "random_id":"80639f82b68d6d97b62f3002c8f9c4aa44*******"
• }

响应参数列表：

编码	列表	内容	备注
1	code	状态码1则为成功
2	msg	状态说明
3	time	当前时间戳
4	data	认证码	认证成功时返回

响应参数示例：

• {
• "code": 1,
• "msg":"认证成功",
• "time":1740886304,
• "data":8a5641
• }

结果码说明：

结果码	说明
1	成功
401	初始化时传入的参数不正确，请检查各个传参是否符合预期。
500，501，503	系统错误
502	系统繁忙
1001	余额不足，请充值后重试！
1002	内部系统出错，请联系厂商

人脸对比：

传入图片与人脸库进行对比

接口协议：

HTTP POST

接口方法：

https://www.gzface.net/api/facet/contrast

请求参数列表:

编码	列表	内容	备注
1	idcard	身份证
2	name	姓名
3	ImageBase64	图片的base64编码数据

请求参数示例：

• {
• "idcard":"5200002000**************",
• "name":"张三"
• "ImageBase64":"/9j/4AAQSKZJRgABAQAA********************"
• }

响应参数列表：

编码	列表	内容	备注
1	code	状态码1则为成功
2	msg	状态说明
3	time	当前时间戳

响应参数示例：

• {
• "code": 1,
• "msg":"认证成功",
• "time":1740886304,
• "data":null
• }

结果码说明：

结果码	说明
1	成功
401	初始化时传入的参数不正确，请检查各个传参是否符合预期。
500，501，503	系统错误
502	系统繁忙
1001	余额不足，请充值后重试！
1002	内部系统出错，请联系厂商