|
@@ -1,18 +1,6 @@
|
1
|
|
-# 人脸核身
|
2
|
|
-### 注意事项
|
3
|
|
-- 获取结果的方式分为 **请求url传回** 和 **重定向带回**
|
4
|
|
-- **请求url传回** 通常适用于“业务端”与“验证端”在不同设备,例如pc端做业务,手机端扫码进入活体核身;**重定向带回** 通常适用于“业务端”与“验证端”在同一浏览器窗口。
|
5
|
|
-- 请调用方根据业务情景选择获取结果的方式
|
6
|
|
-
|
7
|
|
-### 调用流程
|
8
|
|
-1. 接入方调用 `faceCheckInit` 接口初始化人脸小程序sdk
|
9
|
|
-
|
10
|
|
- | 参数名称 |类型|传入/传出| 说明 |
|
11
|
|
- | -------- |--------|-------- |-------- |
|
12
|
|
- | errcode | int | 传出 |非0为异常情况 |
|
13
|
|
- | errmsg | **String** |传出 | 异常情况下的错误信息|
|
14
|
|
-
|
15
|
|
-2. 初始化成功后,调用 `applyUrlToken` 接口换取token(该接口其它参数详见[接口文档](https://docs.qq.com/doc/DWHpQRUZiUk5wSGZa))
|
|
1
|
+### 小程序人脸核身调用流程
|
|
2
|
+1. 接入方调用人脸小程序sdk的初始化方法
|
|
3
|
+2. 初始化成功后,调用 `XXX` 接口换取token和跳转地址
|
16
|
4
|
|
17
|
5
|
| 参数名称 |类型| 说明 |
|
18
|
6
|
| -------- |--------|-------- |
|
|
@@ -29,35 +17,15 @@
|
29
|
17
|
| feedback |是| 传url链接,根据feedbackWay的值使用该链接 |
|
30
|
18
|
| feedbackWay |否| feedback的使用方式<br/>redirect:**重定向带回**,人脸验证完成重定向回feedback; <br/>空:**请求url传回**,人脸验证完成post feedback 的url带回结果|
|
31
|
19
|
|
32
|
|
-
|
33
|
|
-2. 收到token后,调用方传入token信息,调用`startFaceCheck`方法采集人脸,完成核身过程。通过核身结束后返回的地址截取到Id\Key\Token信息,调用方用Id\Key\Token信息调用 `feedback2UrlToken` 接口换取核验结果。
|
34
|
|
- ### `startFaceCheck`接口
|
35
|
|
-
|
|
20
|
+3. 收到BizToken后,调起小程序sdk的人脸核验界面
|
|
21
|
+4. 核验结束,核验界面关闭,调用 `XXX` 接口换取核验结果。
|
|
22
|
+
|
36
|
23
|
| 参数名称 |类型|传入/传出| 说明 |
|
37
|
24
|
| -------- |--------|-------- |-------- |
|
38
|
25
|
| token | String | 传入 |访问token,上一步申请的token |
|
39
|
26
|
| errcode | int | 传出 |非0为异常情况 |
|
40
|
27
|
| errmsg | **String** |传出 | 异常情况下的错误信息|
|
41
|
|
-
|
42
|
|
-
|
43
|
|
-### 获取结果
|
44
|
|
-* 请求url传回
|
45
|
|
- * 用户录完视频得到核验结果后,浏览器将带上以下三个参数post请求 feedback的url。
|
46
|
|
-
|
47
|
|
- | 参数名称 | 类型 | 说明 |
|
48
|
|
- | -------- | -------- | -------- |
|
49
|
|
- | token | String | 访问token,上一步申请的token |
|
50
|
|
- | id | String | 对应的反馈信息id,回调时反馈 |
|
51
|
|
- | key | String | 对应的反馈信息密钥,回调时反馈 |
|
52
|
|
- * 得到三个参数后,调用方调用 `feedback2UrlToken` 接口换取核验结果(详见[接口文档](https://docs.qq.com/doc/DWHpQRUZiUk5wSGZa))
|
53
|
|
- * 页面显示核验结果
|
54
|
|
-
|
55
|
|
-* 重定向带回
|
56
|
|
- * 用户录完视频得到核验结果后,浏览器将feedback拼接上token,id,key三个参数,再跳回到新的feedback。
|
57
|
|
- ` [feedback]?token=[######]&id=[######]&key=[######]`
|
58
|
|
- * 得到三个参数后,调用方调用 `feedback2UrlToken` 接口换取核验结果(详见[接口文档](https://docs.qq.com/doc/DWHpQRUZiUk5wSGZa))
|
59
|
28
|
|
60
|
|
-
|
61
|
29
|
### 时序图
|
62
|
30
|
|
63
|
|
-![时序图](http://assets.processon.com/chart_image/5ff5770c7621315d0d08aea6.png)
|
|
31
|
+![时序图](https://assets.processon.com/chart_image/5ff5770c7621315d0d08aea6.png)
|