更新 'AI/H5活体核身接入文档.md'

AI/H5活体核身接入文档.md

@@ -1,17 +1,46 @@
 # 视频活体核身
+### 注意事项
+- 获取结果的方式分为 **请求url传回** 和 **重定向带回**
+- **请求url传回**适用于“业务端”与“验证端”在不同设备，例如pc端做业务，手机端扫码进入活体核身
+- **重定向带回**适用于“业务端”与“验证端”在同一浏览器窗口
 
-1. 调用 https://cepmtest.dhcccloud.com.cn/switcher/core/applyUrlToken ，使用(身份证，姓名)换取token
-    * 参数action固定传空
-    * bizContent 传 
-        ```
-        {feedback:"一个url",feedbackWay:"feedback的使用方式",idCard:"身份证",name:"姓名",mode:"验证模式"}
-        ```
-    * feedbackWay 微信银行传 redirect
-    * mode : LIP为数字模式,ACTION为动作模式,SILENT为静默模式
-2. 收到token后，浏览器跳转到活体核验页面 https://cepmtest.dhcccloud.com.cn/front-h5/pages/faceVerify/index.html?urltoken=[token]
-3. 用户录完视频得到核验结果后，浏览器跳回到feedback页面，带回token,id,key三个参数。
-4. 调用 https://cepmtest.dhcccloud.com.cn/switcher/core/feedback2UrlToken ，使用token,id,key换取核验结果
+### 调用流程
+1. 调用 `applyUrlToken` 接口换取token（该接口其它参数详见[接口文档](https://docs.qq.com/doc/DWHpQRUZiUk5wSGZa)）
 
+
+    | 参数名称 |类型| 说明 |
+    | -------- |--------|-------- | 
+    | action  | String |固定传空   |
+    | bizContent |  **String** | 见下表bizContent参数，**注意将json对象转字符串**   |
+
+    | bizContent参数 | 说明 |
+    | -------- | -------- | 
+    | idCard  | 核验人的身份证号   |
+    | name  | 核验人的姓名   |
+    | mode  | 核身类型<br/>动作活体：ACTION<br/>数字活体：LIP<br/>静默活体：SILENT   |
+    | feedback  | 验证完成请求该url，或重定向回该url |
+    | feedbackWay  | 获取结果的方式<br/>redirect：**重定向带回**,验证完成重定向回feedback； <br/>空：**请求url传回**,验证完成post该url带回结果  |
+
+
+2. 收到token后，调用方将浏览器跳转到活体核验页面 ` https://cepmtest.dhcccloud.com.cn/front-h5/pages/faceVerify/index.html?urltoken=[######]`
+
+### 获取结果
+* 请求url传回
+   * 用户录完视频得到核验结果后，浏览器将带上以下三个参数post请求 feedback的url。
+
+        | 参数名称 | 类型 | 说明 |
+        | -------- | -------- | -------- |
+        | token    |  String  | 访问token，上一步申请的token  |
+        | id       |  String  | 对应的反馈信息id，回调时反馈   |
+        | key      |  String  | 对应的反馈信息密钥，回调时反馈 |
+   * 得到三个参数后，调用方调用 `feedback2UrlToken` 接口换取核验结果（详见[接口文档](https://docs.qq.com/doc/DWHpQRUZiUk5wSGZa)）
+   * 页面显示核验结果
+
+* 重定向带回
+   * 用户录完视频得到核验结果后，浏览器将feedback拼接上token,id,key三个参数，再跳回到新的feedback。
+     ` [feedback]?token=[######]&id=[######]&key=[######]`
+   * 得到三个参数后，调用方调用 `feedback2UrlToken` 接口换取核验结果（详见[接口文档](https://docs.qq.com/doc/DWHpQRUZiUk5wSGZa)）
+ 
 # 活体人脸比对
 # 照片人脸核身
 # 图片人脸对比