全国自然人任职关联推测模型 V3 - 天远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 { "name": "张三", "id_card": "110101199003074776", "auth_authorize_file_code": "00000000-0000-4000-8000-000000000001" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | name | string | 是 | 姓名 | | id_card | string | 是 | 身份证号；18位身份证号，末位为字母时使用大写X | | auth_authorize_file_code | string | 是 | 先在授权材料中上传已签署的授权书，使用本账号生成且主体、产品范围和有效期匹配的授权编号 | 以上为加密前的业务参数。通过天远现有加密方式得到 Base64 字符串，将其放入请求体的 `data` 字段。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 以下字段为响应中 `data` 解密后的数据结构。示例值用于说明结构，字段含义见下表。 | 字段名 | 类型 | 说明 | |--------|------|------| | data.content | object | 查询结果数据 | | data.fee | integer | 计费标识：1计费，0不计费 | | data.requestId | string | 请求链路ID | | data.content.queryResult | object | 外层包装 | | data.content.queryResult.total | string | 记录数 | | data.content.queryResult.items | array | 外层包装数组 | | data.content.queryResult.items[].relationship | array | 查询人与这家企业的关联:sh-股东 lp-法人tm-高管his_sh-历史股东his_lp-历史法人his_tm-历史高管 | | data.content.queryResult.items[].basicInfo | object | 查询人所在公司基本信息 | | data.content.queryResult.items[].basicInfo.legalPersonName | string | 法人姓名 | | data.content.queryResult.items[].basicInfo.name | string | 企业名 | | data.content.queryResult.items[].basicInfo.regStatus | string | 企业状态 | | data.content.queryResult.items[].basicInfo.regCapital | string | 注册资本 | | data.content.queryResult.items[].basicInfo.companyOrgType | string | 企业类型 | | data.content.queryResult.items[].basicInfo.regNumber | string | 注册号 | | data.content.queryResult.items[].basicInfo.industry | string | 行业 | | data.content.queryResult.items[].basicInfo.estiblishTime | string | 成立日期(注册日期) | | data.content.queryResult.items[].basicInfo.type | string | 法人类型 1-人; 2-公司 | | data.content.queryResult.items[].basicInfo.base | string | 省份简称 | | data.content.queryResult.items[].basicInfo.his_staffList | object | his_staffList | | data.content.queryResult.items[].basicInfo.his_staffList.result | array | 查询结果 | | data.content.queryResult.items[].basicInfo.his_staffList.result[].isLerepsign | string | isLerepsign | | data.content.queryResult.items[].basicInfo.his_staffList.result[].typeJoin | array | typeJoin | | data.content.queryResult.items[].basicInfo.his_staffList.result[].type | string | 法人类型 1-人; 2-公司 | | data.content.queryResult.items[].basicInfo.his_staffList.result[].name | string | 企业名 | | data.content.queryResult.items[].basicInfo.staffList | object | 主要人员 | | data.content.queryResult.items[].basicInfo.staffList.result | array | 查询结果 | | data.content.queryResult.items[].basicInfo.staffList.result[].typeJoin | array | typeJoin | | data.content.queryResult.items[].basicInfo.staffList.result[].type | string | 法人类型 1-人; 2-公司 | | data.content.queryResult.items[].basicInfo.staffList.result[].name | string | 企业名 | | data.content.queryResult.items[].basicInfo.creditCode | string | 统一社会信用代码 | | data.content.queryResult.items[].basicInfo.regCapitalCurrency | string | 注册资本币种:人⺠币、 美元、 欧元等 | | data.content.queryResult.items[].his_stockHolderItem | object | 历史查询人持股信息展示字段与 | | data.content.queryResult.items[].his_stockHolderItem.investRate | string | 占比 | | data.content.queryResult.items[].his_stockHolderItem.orgHolderType | string | 股东类型 | | data.content.queryResult.items[].his_stockHolderItem.orgHolderName | string | 股东名 | | data.content.queryResult.items[].his_stockHolderItem.investDate | string | 出资时间 | | data.content.queryResult.items[].his_stockHolderItem.paidinAmt | string | paidinAmt | | data.content.queryResult.items[].his_stockHolderItem.subscriptAmt | string | 出资金额 | | data.content.queryResult.items[].adminPenalty | array | 行政处罚 | | data.content.queryResult.items[].adminPenalty[].decisionDate | string | 处罚日期 | | data.content.queryResult.items[].adminPenalty[].punishNumber | string | 决定文书号 | | data.content.queryResult.items[].adminPenalty[].departmentName | string | 处罚单位 | | data.content.queryResult.items[].adminPenalty[].legalPersonName | string | 法人姓名 | | data.content.queryResult.items[].adminPenalty[].content | string | 处罚结果/内容 | | data.content.queryResult.items[].adminPenalty[].type | string | 法人类型 1-人; 2-公司 | | data.content.queryResult.items[].adminPenalty[].reason | string | 处罚事由/违法行为类型 | | data.content.queryResult.items[].stockholder | object | 查询人持股信息 | | data.content.queryResult.items[].stockholder.subscriptAmt | string | 出资金额 | | data.content.queryResult.items[].stockholder.investDate | string | 出资时间 | | data.content.queryResult.items[].stockholder.orgHolderType | string | 股东类型 | | data.content.queryResult.items[].stockholder.orgHolderName | string | 股东名 | | data.content.queryResult.items[].stockholder.investRate | string | 占比 | | data.content.queryResult.items[].stockholder.paidinAmt | string | paidinAmt | | data.content.queryResult.items[].pName | string | 查询人名称 | | data.content.queryResult.items[].orgName | string | 查询人对应企业名 | | data.content.queryResult.items[].dishonestExecutedPerson | array | 被执行人(人员) | | data.content.queryResult.items[].dishonestExecutedPerson[].type | string | 法人类型 1-人; 2-公司 | | data.content.queryResult.items[].dishonestExecutedPerson[].unperformPart | string | 未履行部分 | | data.content.queryResult.items[].dishonestExecutedPerson[].courtname | string | 法院 | | data.content.queryResult.items[].dishonestExecutedPerson[].performance | string | 履行情况 | | data.content.queryResult.items[].dishonestExecutedPerson[].gistunit | string | 做出执行的依据单位 | | data.content.queryResult.items[].dishonestExecutedPerson[].cardnum | string | 身份证号码/组织机构代码 | | data.content.queryResult.items[].dishonestExecutedPerson[].iname | string | 失信人名称 | | data.content.queryResult.items[].dishonestExecutedPerson[].gistid | string | 执行依据文号 | | data.content.queryResult.items[].dishonestExecutedPerson[].disrupttypename | string | 失信被执行人行为具体情形 | | data.content.queryResult.items[].dishonestExecutedPerson[].areaname | string | 省份地区 | | data.content.queryResult.items[].dishonestExecutedPerson[].publishdate | string | 发布时间 | | data.content.queryResult.items[].dishonestExecutedPerson[].duty | string | 生效法律文书确定的义务 | | data.content.queryResult.items[].dishonestExecutedPerson[].regdate | string | 立案时间 | | data.content.queryResult.items[].dishonestExecutedPerson[].casecode | string | 案号 | | data.content.queryResult.items[].dishonestExecutedPerson[].performedPart | string | 已履行部分 | | data.content.queryResult.items[].dishonestExecutedPerson[].businessentity | string | 法人、 负责人姓名 | | data.content.queryResult.items[].executedPerson | array | 被执行人(人员) | | data.content.queryResult.items[].executedPerson[].caseCreateTime | string | 立案日期 | | data.content.queryResult.items[].executedPerson[].caseCode | string | 案号 | | data.content.queryResult.items[].executedPerson[].execMoney | string | 执行标的(元) | | data.content.queryResult.items[].executedPerson[].pname | string | 被执行人名称 | | data.content.queryResult.items[].executedPerson[].partyCardNum | string | 身份证号/组织机构代码 | | data.content.queryResult.items[].executedPerson[].execCourtName | string | 执行法院 | | data.content.result | string | 查询结果 |