请求端点

{
    "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. 用户提交信息

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

2. 数据加密传输

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

3. 接口调用

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

4. 响应处理

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

5. 结果展示

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

---

二、应用场景

1. 金融风控

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

2. 租赁行业

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

3. 企业招聘与人事

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

4. 保险与理财

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

5. 电商与分期消费

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

---