身份证OCR - 天远数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 { "image_url":"string", "photo_data": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | image_url| string | 否 | 身份证图片地址，与 身份证图片base64编码 二选一 | | photo_data| string | 否 | 身份证图片base64编码 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

# 身份证扫描接口返回参数说明 ## 基础返回字段 | 字段名 | 说明 | |--------|------| | order_no | 订单号 | | result | 扫描成功 0 收费；扫描失败 1 不收费 | | side | 身份证方向信息。front 代表身份证正面(人像面)，back 代表身份证反面(国徽面) | | info | 身份证信息，分正面和反面，见详情 | | validity | 扫描成功结果，分正面和反面，见详情 | | image_url | 身份证头像照片URL，有效期一个小时 | --- ## info 返回字段 | 字段名 | 说明 | |--------|------| | name | 姓名 | | sex | 性别 | | nation | 民族 | | year | 出生年 | | month | 出生月 | | day | 出生日 | | address | 地址 | | number | 身份证号 | | authority | 签发机关 | | timelimit | 身份证有效期 | > **注意：** > - 上传身份证正面照片时返回字段：`name`、`sex`、`nation`、`year`、`month`、`day`、`address`、`number` > - 上传身份证背面照片时返回字段：`authority`、`timelimit` --- ## validity 返回字段 | 字段名 | 说明 | |--------|------| | birthday | 生日 | | number | 身份证号 | | address | 地址 | | sex | 性别 | | name | 姓名 | | authority | 签发机关 | | timelimit | 身份证有效期 | > **注意：** > - 上传身份证正面照片时返回字段：`name`、`sex`、`nation`、`year`、`month`、`day`、`address`、`number` > - 上传身份证背面照片时返回字段：`authority`、`timelimit` --- ## 非身份证图片处理说明 当上传的图片是非身份证图片时，系统不会报错，但此时 `validity` 中所有字段都会为 `false`，请参考 `validity` 字段进行判断。