企业五要素验证

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 { "mobile_no": "string", "ent_name": "string", "legal_person": "string", "ent_code": "string", "id_card": "string", "mobile_no": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | ent_name| string | 是 | 企业名称 | | ent_code| string | 是 | 企业统一信用代码 | | legal_person| string | 是 | 法人姓名 | | id_card| string | 是 | 法人身份证号码 | | mobile_no | string | 是 | 手机号 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ## 2. 企业信息 (Enterprise Information) | 字段 | 类型 | 值 | 说明 | |------|------|----|------| | success | Boolean | `true` | 接口调用是否成功 | | message | String | `"ok"` | 返回的状态描述信息 | | data | Object | - | 包含具体认证结果的嵌套对象 | | data.result | Number | `1` | 企业认证结果代码（`1` 认证通过） | | data.remark | String | `"一致"` | 备注企业登记信息一致 | ## 2. 个人信息 (Personal Information) # 返回参数说明 ## 1. 基础参数 | 参数名 | 类型 | 示例 | 说明 | |--------|------|------|------| | orderNo | STRING | `011569554991100011` | 业务唯一流水号 | | handleTime | STRING | `2018-04-09 15:05:01` | 查询时间 | | type | STRING | `1` / `2` / `3` / `4` | 运营商类型：<br>1-移动<br>2-联通<br>3-电信<br>4-广电 | | result | STRING | `01` / `02` / `03` / `04` | 认证结果：<br>01-一致<br>02-不一致<br>03-不确定<br>04-失败,虚拟号 | | gender | STRING | `1` / `2` | 性别：<br>1-男<br>2-女 | | age | STRING | `26` | 年龄 | | remark | STRING | `一致` | 备注信息 | --- ## 2. 详情信息 (detail) `detail` 为 JSON 对象，包含更细粒度的认证结果说明。 ### 2.1 detail 字段结构 | 参数名 | 类型 | 说明 | |--------|------|------| | code | STRING | 详细的返回代码，含义如下： | | remark | STRING | 详细描述信息 | ### 2.2 code 返回值说明 | code | 含义 | |------|------| | `02` | 手机号已实名，但是身份证和姓名均与实名信息不一致 | | `03` | 手机号已实名，手机号和证件号一致，姓名不一致 | | `04` | 手机号已实名，手机号和姓名一致，身份证不一致 | | `05` | 其他不一致 | | `06` | 姓名身份证不一致 | --- # status字段说明 | 字段名 | 类型 | 必填 | 可能值 | 说明 | |----------|--------|------|--------|------------------------------| | status | int | 是 | 0 | 验证通过 | | | | | 1 | 企业信息不正确 | | | | | 2 | 身份证号码不正确 |

## 响应示例 ### 成功响应 ``` { "Enterprise Information": { "data": { "remark": "一致", "result": 1 }, "message": "ok", "success": true }, "Personal Information": { "age": "26", "gender": "1", "handleTime": "2025-12-09 14:49:06", "orderNo": "euDe1150442837701251072", "remark": "认证一致", "result": "01", "type": "1" } "status": { "status": 0 } } ```

## 错误代码 | code | message | |------|---------| | 0 | 业务成功 | | 1000 | 查询为空 | | 1001 | 接口异常 | | 1002 | 参数解密失败 | | 1003 | 基础参数校验不正确 | | 1004 | 未经授权的IP | | 1005 | 缺少Access-Id | | 1006 | 未经授权的AccessId | | 1007 | 账户余额不足，无法请求 | | 1008 | 未开通此产品 | | 2001 | 业务失败 |