启动 H5 人脸核身

一、前置条件

注意：1. 内调用 H5 人脸核身或者短信链接调用 H5 人脸核身等场景，若当前设备无法正常调用摄像头进行视频录制，前端将返回特定的错误码（如下）告知合作方，合作方拿到错误码后可选择用备用方案核身处理。

注意：2. 在 App、微信公众号、浏览器中调用 H5 实时检测人脸核身，需要用户允许使用摄像头权限（授权操作形式包括弹窗、动作菜单、应用设置等，具体形式视手机型号而异）。如用户误操作导致拒绝授权，需要退出人脸核身并重新进入和允许授权。部分浏览器会缓存用户之前的授权操作，故如果退出人脸核身并重新进入时仍然出现无摄像头权限的情况，可以尝试清除浏览器缓存。

二、摄像头授权操作示例：

形式1： 弹窗（popup）

形式2 ：动作菜单（action sheet）

形式3： 应用设置（setting）

三、前置条件

请合作方确保 NONCE ticket 已经正常获取，获取方式见 NONCE ticket 获取。

注意：说明：

四、基本步骤

1. 生成一个 32 位的随机字符串（字母和数字）nonce（接口请求时也要用到）。

2. 将 appId、userId、orderNo、version、faceId 连同 ticket、nonce 共 7 个参数的值进行字典序排序。

3. 将排序后的所有参数字符串拼接成一个字符串。

4. 将排序后的字符串进行 SHA1编码，编码后的 40 位字符串作为签名（sign）。

注意：签名算法可参考 签名算法说明。

五、参考示例

请求参数：

字典排序后的参数为：

`"1.0.0"`

拼接后的字符串为：

`"1.0.0aabc1457895464appId001bwiwe1457895464kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7TuserID19959248596551zxc9Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS"`

计算 SHA1 得到签名：

`"4E9DFABF938BF37BDB7A7DC25CCA1233D12D986B 该字串就是最终生成的签名（40 位），不区分大小写。"`

六、启动 H5 人脸核身

合作方上送 h5faceId 以及 sign，后台校验 sign 通过之后重定向到 H5 人脸核身。为了保证服务的高可用，全面消除单点风险，我们启用了多域名服务。启动 H5 人脸核身需要使用 合作方后台上送身份信息 接口返回内容中 optimalDomain 字段的域名。

请求 URL：

https://{optimalDomain}/s/web/h5

注意：1. optimalDomain 使用合作方后台上送身份信息 接口返回的 optimalDomain 域名，如果 optimalDomain 字段返回为空或者取不到，默认使用域名 kyc1.qcloud.com。

注意：2. 该跳转 url 不能直接暴露在前端 html 页面的<a>标签中。某些浏览器会预加载<a>标签中的 url，导致用户点击访问该 url 时，因 url 已经被预加载访问过，于是签名失效，页面报错“签名不合法”。

注意：3. 合作方如果使用 iframe 框架，需要给 iframe 开启相机权限 allow="camera;"，并且内外层都需要使用 https 协议，方可正常使用实时检测人脸核身功能。

注意：示例：<iframe allow="camera *;autoplay *;"></iframe>

请求方法：GET

请求参数：

请求示例：

https://kyc1.qcloud.com/s/web/h5?appId=appId001&version=1.0.0&nonce=4bu6a5nv9t678m2t9je5819q46y9hf93&orderNo=161709188560917432576916585&faceId=tx04f10695c3651ce155fea7070b74c9&userId=23333333333333&sign=5DD4184F4FB26B7B9F6DC3D7D2AB3319E5F7415F