活体识别V步骤1 - 天远数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | Access-Id | string | 是 | 账号的 Access-Id | 对于业务请求参数 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`，以此方式进行传参。 ```json { "data": "xxxx(base64)" } ``` 对接响应得到的公共参数 ```json { "code": "int", "message": "string", "transaction_id": "string", // 流水号 "data": "string" } ``` **data** 字段为加密的数据，需要解密后查看。 ## 加密和解密机制 账户获得的密钥（**Access Key**）是一个 16 进制字符串，使用 AES-128 加密算法。 ### 加密过程： - 加密模式：**AES-CBC 模式**。 - 密钥长度：**128 位（16 字节）**。 - 填充方式：**PKCS7 填充**。 - **IV（初始化向量）**：IV 长度为 16 字节（128 位），每次加密时随机生成。 - 加密后，将 **IV** 和密文拼接在一起进行传输。 - 最后，将拼接了 IV 的密文通过 **Base64 编码**，方便在网络或文件中传输。 ### 解密过程： - 解密时，首先从 Base64 解码后的数据中提取前 16 字节作为 **IV**。 - 然后使用提取的 **IV**，通过 AES-CBC 模式解密剩余部分的密文。 - 解密后去除 **PKCS7 填充**，即可得到原始明文。

## 请求参数 以下字段均为调用本接口时传入的业务参数（加密前 JSON 对象）。字段名为平台规范；服务端会映射为数脉对应参数。 ```json { "return_url": "string", "version": "string", "action_live_param": "string", "style": "string", "action_mutex": true, "anti_camera_hack": true, "fore_live_on": true, "back_live_on": true, "show_success": true, "show_fail": true, "hide_guide_page": true, "title": "string", "enable_h5_compatible_model": true, "return_url_include_token": true } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | return_url | string | 是 | 活体检测完成后回调页面的 URL | | version | string | 否 | 小程序场景传 `h6`，获取新域名的前端检测地址 | | action_live_param | string | 否 | 动作数组，英文逗号分隔，例如 `LookLeft,OpenMouth`；默认不传，详见动作说明 | | style | string | 否 | 动作样式，目前支持 `1` 和 `2`。<br>样式 `1`：随机从摇头、点头、左转头、右转头 4 个头部动作中选取一个，再随机从眨眼、张嘴 2 个局部动作中选取一个，并随机组合顺序。<br>样式 `2`：随机从眨眼、张嘴 2 个局部动作中选取一个 | | action_mutex | boolean | 否 | 是否检查动作互斥，默认 `false`（不检查；动作不匹配时不会立即失败） | | anti_camera_hack | boolean | 否 | 是否开启闪光防摄像头劫持检测，默认 `false`（随机闪光检查视频是否为实时采集，对光线环境有一定要求） | | fore_live_on | boolean | 否 | 是否开启前端小模型活体算法，资源消耗小、速度快，在客户端运行，默认 `true` | | back_live_on | boolean | 否 | 是否开启云端大模型活体算法，资源消耗大、速度慢，在服务器端运行，默认 `false` | | show_success | boolean | 否 | 是否展示采集成功的结果页面，默认 `false` | | show_fail | boolean | 否 | 是否展示采集失败的结果页面（含失败原因，便于问题诊断），默认 `true` | | hide_guide_page | boolean | 否 | 是否隐藏引导页：`false` 不隐藏，`true` 隐藏，默认 `false` | | title | string | 否 | 采集页面标题，最长 32 字符，默认「活体人脸采集」 | | enable_h5_compatible_model | boolean | 否 | `true`：H5 不支持算法预检时使用原生相机录制视频；`false`：需用户将采集 URL 复制到其他环境完成采集，默认 `true` | | return_url_include_token | boolean | 否 | 跳转 `return_url` 时是否在 URL 携带 token（浏览器暴露 token 不安全，建议传 `false`），默认 `true` | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ### 返回字段说明 | 字段名 | 说明 | | ------ | ---- | | token | 采集及获取结果时所使用的凭证，有效期 2 个小时，在此时效内，应用侧可以发起采集请求（重复的采集所触发的结果会被忽略）和结果查询 | | url | 采集所使用的地址，应用应引导前端程序跳转到此地址 |