本文介绍了PC或移动端H5网页的接入流程。

手机浏览器支持列表

浏览器名称 支持情况
Edge 支持
FireFox 支持
Chrome 支持
Safari 支持( iOS 11及以上)
Opera 支持
Android Browser 5.0+ 支持
UC 支持
QQ 支持
厂商内置浏览器 华为、三星等部分机型支持
说明 受制于浏览器兼容性碎片化问题,建议您在流程设计上引导用户使用推荐的浏览器完成认证。若您是App内集成该方案,可能会因为内嵌浏览器原因无法兼容,推荐您使用SDK模式接入;若您是通过微信的公众号或者小程序集成,基于微信运营审核规则限制,可能出现无法避免的兼容性问题,建议您使用纯服务端(API)接入方式。

启动刷脸

<script type="text/javascript"src="https://cn-shanghai-aliyun-cloudauth.oss-cn-shanghai.aliyuncs.com/web_sdk_js/jsvm_all.js" ></script>
  1. 引入上述JS文件,调用函数getMetaInfo() 获取MetaInfo。
  2. 您在调用实人认证服务端发起请求时需要传入该MetaInfo值。
  3. 获取服务端初始化返回的CertifyUrl,在浏览器中加载该链接进行实人认证。

结果解析

CertifyUrl中ReturnUrl参数为商户自定义,结果会在扫脸完成后拼接在ReturnUrl后面作为参数返回给商户,格式如下:
response=%7B"code"%3A1001%2C"subCode"%3A"Z5051"%2C"reason"%3A"success"%2C"extInfo"%3A%7B%7D%7D
从URL中获取Response参数,URL解码后格式如下:
{
  "code":"",
  "subCode":"",
  "reason":"",
  "extInfo" : {}
}

错误码

错误码 错误码文案 错误码描述
1000 刷脸成功 代表刷脸成功,该结果仅供参考,可通过服务端获取最终认证结果。具体内容,请参见查询认证结果
1001 系统错误 表示系统错误。
1003 验证中断 表示验证中断。
2002 网络错误 表示网络错误。
2003 客户端设备时间错误 表示客户端设备时间错误。
2006 刷脸失败 表示刷脸失败,如需获取更详细的失败原因,需调用服务端查询认证结果。具体内容,请参见查询认证结果
表 1. subCode说明
错误码 错误码文案 错误码描述
Z5052 数据错误或程序异常 表示数据错误或程序异常。
Z5056 重试次数过多 表示重试次数过多。
Z5055 用户退出 表示用户退出。
Z5054 摄像头无权限或者无法获取摄像头数据出错 表示摄像头无权限或者无法获取摄像头数据出错。