企业各类工商风险统计数量(全国版） - 天远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 { "ent_code": "string", "ent_name": "string", } ``` ### 请求参数 | 字段名 | 类型 | 描述 | 是否必填 | |----------|--------|----------------------------------------|----------| | ent_code| string | 企业注册号或统一社会信用代码 | 与ent_name选填一个 | | ent_name| string | 企业全名 | 与ent_code选填一个 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ### 返回参数 | 参数名称 | 描述 | 类型 | |-----------------------------------|----------------------|----------| | tender_list_count | 招投标列表数量 | STRING | | spot_check_count | 抽查检查数量 | STRING | | serious_offense_count | 严重违法数量 | STRING | | abnormal_operation_count | 经营异常数量 | STRING | | administrative_license_count | 行政许可数量 | STRING | | equity_freeze_count | 股权冻结数量 | STRING | | equity_pledge_count | 股权出质数量 | STRING | | chattel_mortgage_count | 动产抵押数量 | STRING | | alter_data_count | 变更记录数量 | STRING | | key_personnel_count | 主要人员数量 | STRING | | shareholder_count | 工商股东数量 | STRING | | engineering_qualification_count | 工程资质资格数量 | STRING | | great_tax_illegal_count | 重大税收违法数量 | STRING | | high_tech_qualification_count | 高新技术企业资质数量 | STRING | | administrative_punish_count | 行政处罚数量 | STRING | | owing_taxes_count | 欠税信息数量 | STRING | | bond_basis_count | 债券基础信息数量 | STRING | | abnormal_household_count | 非正常户数量 | STRING | | invest_count | 对外投资数量（最优股比） | STRING | | recruit_count | 招聘信息数量 | STRING | | judicial_aid_count | 司法协助数量 | STRING | | punish_env_count | 环保处罚列表数量 | STRING | | branch_count | 分支机构数量 | STRING | | total_count | 所有信息数量 | STRING | ### 系统代码 | 代码 | 描述 | |--------|------------------------------------| | 200 | 操作成功 | | 500 | 系统内部错误 | | 3001 | 商家相关报错（商家不存在、商家被禁用、商家余额不足） | | 3002 | 账户已过期 | | 3003 | 未添加 IP 白名单 | | 3004 | 未授权调用该接口 | | 4001 | 产品 id 错误 | | 4002 | 接口被停用 | | 5001 | 接口查询异常，请联系技术人员 | | 6000 | 未查询到结果 |