大数据接口 - 收入评估(社保评级)API

请求端点

{

    "post": "https://api.tianyuanapi.com/api/v1/JRZQ09J8?t=13位时间戳"

}

请求头

| 字段名 | 类型 | 必填 | 描述 |

|--------|------|------|------|

| Access-Id | string | 是 | 账号的 Access-Id |

对于业务请求参数

通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 data，以此方式进行传参。

{

    "data": "xxxx(base64)"

}

对接响应得到的公共参数

{

    "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 填充**，即可得到原始明文。

请求参数

{

    "mobile\_no": "string",

    "id\_card": "string",

    "name": "string"

}

| 字段名 | 类型 | 必填 | 描述 |

|--------|------|------|------|

| mobile_no | string | 是 | 手机号 |

| id_card | string | 是 | 身份证号 |

| name | string | 是 | 姓名 |

通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 data。

{

    "data": "xxxx(base64)"

}

返回字段说明

评级对照表

| level 值 | 社保评级 | 对应月收入范围 |

|----------|--------------|----------------------|

| - | **无记录** | 查询无社保记录 |

| A | **A级** | （2000, 4000）元 |

| B | **B级** | （4000, 6000）元 |

| C | **C级** | （6000, 8000）元 |

| D | **D级** | （8000, 10000）元 |

| E | **E级** | （10000, 14000）元 |

| F | **F级** | （14000, 18000）元 |

| G | **G级** | （18000, 22000）元 |

| H | **H级** | （22000, 26000）元 |

| I | **I级** | （26000, 30000）元 |

| J | **J级** | （30000+）元 |

响应示例

{

    "level": "A"

}

错误代码

| code | message |

|------|---------|

| 0 | 业务成功 |

| 1000 | 查询为空 |

| 1001 | 接口异常 |

| 1002 | 参数解密失败 |

| 1003 | 基础参数校验不正确 |

| 1004 | 未经授权的IP |

| 1005 | 缺少Access-Id |

| 1006 | 未经授权的AccessId |

| 1007 | 账户余额不足，无法请求 |

| 1008 | 未开通此产品 |

| 2001 | 业务失败 |

应用场景文档

本文档介绍了基于 **天远API 社保评级查询接口** 的应用场景，涵盖 **业务流程、应用领域、接口调用示例** 以及 **典型案例**。

一、业务流程

1. **用户提交信息**

• 用户输入手机号、身份证号、姓名。

1. **数据加密传输**

• 使用账户的 **Access Key** 对业务参数进行 AES-128-CBC 加密（PKCS7 填充），拼接 IV 后进行 Base64 编码。
• 将加密后的字符串放入请求体 data 字段中。

1. **接口调用**

• 发起 POST 请求到指定接口地址，携带请求头 Access-Id 与请求体。

1. **响应处理**

• 接口返回加密数据（Base64 格式）。
• 解密数据，获取社保评级结果。

1. **结果展示**

• 根据 level 字段，转换为社保评级和对应的月收入范围。
• 展示给业务方或用户。

二、应用场景

1. 金融风控

• **贷款审批**：通过查询社保评级，判断申请人的收入水平，辅助风险控制。
• **信用卡申请**：银行可用社保评级验证申请人收入是否满足发卡标准。

2. 租赁行业

• **房屋租赁**：中介或房东可根据社保评级评估租客的还款能力。
• **长租公寓**：平台可基于评级决定是否支持租客分期付款。

3. 企业招聘与人事

• **背景调查**：HR 可通过社保评级初步验证候选人的收入和社保缴纳情况。
• **岗位匹配**：帮助判断候选人与岗位薪资区间是否匹配。

4. 保险与理财

• **保险定价**：保险公司可结合社保评级，进行个性化保费定价。
• **理财推荐**：理财平台可根据收入水平推荐合适的投资产品。

5. 电商与分期消费

• **分期付款评估**：电商平台可通过社保评级判断用户的分期还款能力。
• **会员等级划分**：根据收入评级，将用户划分为不同的会员等级，给予差异化权益。