活体识别步骤二 - 天远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 { "token": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | token| string | 是 | token凭证| 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 | 字段名 | 说明 | | ------ | ---- | | result | 活体检测结果标识：<br>- `0`：活体检测通过<br>- `1`：活体检测不通过<br>- `2`：未找到活体检测结果<br>注：`0` 和 `1` 状态收费 | | codeDesc | 对应描述。不通过时可能返回以下描述：<br>1. 动作与指令不匹配，请注意动作的速度和幅度<br>2. 未在等待时间内采集到正确动作<br>3. 未能采集到质量合格的活体人脸照片<br>4. 未通过前端活体检测算法<br>5. 未通过后端活体检测算法 | | faceUrl | 采集到活体人像裁剪后人脸的下载地址，内容是 JPEG 流，文件大小一般不超过 50KB，有效期 1 个小时，需要保存请及时下载。<br>注：仅当活体检测通过（`result=0`）时返回该地址 |