|
@@ -1,30 +1,33 @@
|
1
|
1
|
### 小程序人脸核身调用流程
|
2
|
2
|
1. 接入方调用人脸小程序sdk的初始化方法
|
3
|
|
-2. 初始化成功后,调用 `XXX` 接口换取token和跳转地址
|
|
3
|
+2. 初始化成功后,调用 `faceCheckInit` 接口换取token和跳转地址
|
4
|
4
|
|
5
|
|
- | 参数名称 |类型| 说明 |
|
6
|
|
- | -------- |--------|-------- |
|
7
|
|
- | action | String |固定传空 |
|
8
|
|
- | bizContent | **String** | 见下表bizContent参数,**注意将json对象转字符串** |
|
9
|
|
-
|
10
|
|
- | bizContent参数 |是否必传| 说明 |
|
11
|
|
- | -------- | -------- | -------- |
|
12
|
|
- | idNum |条件必传| 身份证号 |
|
13
|
|
- | name |条件必传| 姓名 |
|
14
|
|
- | origin |条件必传| 图片文件类型<br/> base64传输:self<br/>来自文件服务器:fds (**带压缩效果,推荐使用,详见[fds使用文档](../file/文件服务器接口.md))**<br/>链接:uri |
|
15
|
|
- | data |条件必传| 文件内容(base64,文件服务器文件名或链接) |
|
16
|
|
- | | | **idNum和name一组,origin和data一组,两组数据必传一组,不能同时传两组** |
|
17
|
|
- | feedback |是| 传url链接,根据feedbackWay的值使用该链接 |
|
18
|
|
- | feedbackWay |否| feedback的使用方式<br/>redirect:**重定向带回**,人脸验证完成重定向回feedback; <br/>空:**请求url传回**,人脸验证完成post feedback 的url带回结果|
|
|
5
|
+ | 参数名称 | 类型 | 传入/传出 | 是否必传 | 说明 |
|
|
6
|
+ | -------- |--------|-------- |-------- | -------- |
|
|
7
|
+ | ruleId | String | 传入 |是 |得去腾讯创建|
|
|
8
|
+ | idCard | String | 传入 |否 |身份证,|
|
|
9
|
+ | name | String |传入|否 |姓名|
|
|
10
|
+ | redirectUrl| String |传入|是 |认证结束后重定向的回调链接地址。最长长度1024位。|
|
|
11
|
+ | imageBase64 | DataItem |传入|否 |用于人脸比对的照片,和idCard、name俩个之中必须输入一种|
|
|
12
|
+ | isSuccess | boolean |传出|否 |是否初始化成功|
|
|
13
|
+ | errorMessage | boolean |传出|否 |错误码|
|
|
14
|
+ | url | String |传出|否 |腾讯返回的地址(小程序不使用)|
|
|
15
|
+ | bizToken | String |传出|否 |完成核身后,可用该标识获取验证结果信息。|
|
|
16
|
+ | requestId | String |传出|否 |流水号|
|
|
17
|
+
|
19
|
18
|
|
20
|
19
|
3. 收到BizToken后,调起小程序sdk的人脸核验界面
|
21
|
|
-4. 核验结束,核验界面关闭,调用 `XXX` 接口换取核验结果。
|
|
20
|
+4. 核验结束,核验界面关闭,调用 `getFaceCheckResult` 接口换取核验结果。
|
22
|
21
|
|
23
|
|
- | 参数名称 |类型|传入/传出| 说明 |
|
24
|
|
- | -------- |--------|-------- |-------- |
|
25
|
|
- | token | String | 传入 |访问token,上一步申请的token |
|
26
|
|
- | errcode | int | 传出 |非0为异常情况 |
|
27
|
|
- | errmsg | **String** |传出 | 异常情况下的错误信息|
|
|
22
|
+ | 参数名称 |类型|传入/传出| 是否必传| 说明 |
|
|
23
|
+ | -------- |--------|-------- |-------- |-------- |
|
|
24
|
+ | bizToken | String | 传入 |是 |人脸核身流程的标识 |
|
|
25
|
+ | ruleId | String | 传入 |是 |非0为异常情况 |
|
|
26
|
+ | infoType | String | 传入 | 是 |异常情况下的错误信息|
|
|
27
|
+ | isSuccess | boolean |传出|否 |是否初始化成功|
|
|
28
|
+ | errorMessage | boolean |传出|否 |错误码|
|
|
29
|
+ | DetectInfo | String | 传出 | 否 |文本类信息|
|
|
30
|
+ | requestId | String |传出|否 |流水号|
|
28
|
31
|
|
29
|
32
|
### 时序图
|
30
|
33
|
|