企业联系人实际经营地址 - 天远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 { "EntName": "string", "EntCode": "string", "Authorized": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |-------------|--------|------|------| | EntName | string | 否 | 企业名称，校验规则：`omitempty,min=1,validEnterpriseName` | | EntCode | string | 否 | 统一社会信用代码，校验规则：`omitempty,validUSCI` | | Authorized | string | 是 | 授权标识，取值必须为 `0` 或 `1`，校验规则：`required,oneof=0 1` | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

# 返回字段说明 ## 字段说明 | 名称 | 说明 | 备注 | |--------------------|------------------|------------------------------| | companyName | 企业名称 | | | creditCode | 统一社会信用代码 | | | legalPersonName | 法定代表人 | | | address | 实际经营地址 | | | contactInfo | 联系信息 | 包含子节点 | | personName | 联系人 | contactInfo 子节点 | | contactInformation | 联系方式 | contactInfo 子节点 | | level | 推荐等级 | contactInfo 子节点 | ## 失败返回示例 ``` json { "code": "307", "message": "身份证号错误", "data": null } ``` ## 返回公共字段 | 字段名 | 类型 | 说明 | |----------|----------|----------------------| | code | String | 返回状态码 | | message | String | 响应状态码说明 | | data | Object | 响应的主体数据 | | success | Boolean | 请求是否成功 | ## 状态码附录 | 返回状态码 | 说明 | |------------|--------------------------| | 200 | 请求成功 | | 201 | 查询无记录 | | 302 | 业务参数缺失 | | 303 | 参数错误 | | 304 | 请求头参数缺失 | | 305 | 姓名错误 | | 306 | 手机号错误 | | 307 | 身份证号错误 | | 308 | 服务不存在 | | 309 | 服务未开通 | | 310 | 余额不足 | | 311 | 调用远程数据异常 | | 312 | 用户不存在 | | 313 | 用户状态异常 | | 314 | 用户未授权 | | 315 | 白名单错误 | | 316 | timestamp不合法 | | 317 | timestamp已过期 | | 318 | 验签失败 | | 319 | 解密失败 | | 320 | 未授权 | | 500 | 系统异常,请联系管理员 |