活体识别V步骤1 - 天远API

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 { "return_url": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | return_url | string | 是 | 请求回调，详见请求token回调详情 | ## 获取token后回调信息 | 字段名 | 类型 | 必填 | 说明 | |----------------------------|-----------|------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | returnUrl | varchar | 是 | 活体检测完成后回调页面的 URL | | actionLiveParam | varchar | 否 | 动作数组，用英文逗号分隔，例如：`LookLeft,OpenMouth`。默认不需要传，具体说明请查看“动作说明” | | style | varchar | 否 | 动作样式选择，目前支持 1 和 2：<br>样式 1：随机从摇头、点头、左转头、右转头 4 个头部动作中选取一个动作，再随机从眨眼和张嘴 2 个局部动作中选取一个动作，然后随机组合这两个动作的顺序<br>样式 2：随机从眨眼和张嘴 2 个局部动作中选取一个动作 | | actionMutex | Boolean | 否 | 是否检查动作互斥，默认 false（不检查动作互斥）。即动作不匹配时不会立即失败 | | antiCameraHack | Boolean | 否 | 是否开启闪光防摄像头劫持检测，默认 false。即随机性闪光检查视频是否为实时采集，对光线环境会有一定要求 | | foreLiveOn | Boolean | 否 | 是否开启前端小模型活体算法，资源消耗小，速度快，在客户端运行。默认 true | | backLiveOn | Boolean | 否 | 是否开启云端大模型活体算法，资源消耗大，速度慢，在服务器端运行。默认 false | | showSuccess | Boolean | 否 | 是否展示采集成功的结果页面。默认 false | | showFail | Boolean | 否 | 是否展示采集失败的结果页面，会显示失败的具体原因，有利于问题诊断。默认 true | | hideGuidePage | Boolean | 否 | 是否隐藏引导页，false 为不隐藏，true 为隐藏。默认 false | | title | varchar | 否 | 采集页面的标题文本，最长 32 个字符。默认 `"活体人脸采集"` | | enableH5CompatibleModel | Boolean | 否 | true 表示 H5 环境不支持算法预检时将使用原生相机录制视频的方式；false 表示 H5 环境不支持算法预检时将需要用户手动将采集 URL 复制到其他可用环境完成采集。默认 true | | returnUrlIncludeToken | Boolean | 否 | 跳转到 returnUrl 后是否携带 token 参数；因为 token 暴露在浏览器是不安全的，建议主动设置为 false（不携带）。默认值 true（携带），因历史遗留问题导致 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

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