請求端點

{"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. 電商與分期消費

• 分期付款評估：電商平臺可通過社保評級判斷用戶的分期還款能力。
• 會員等級劃分：根據收入評級，將用戶劃分為不同的會員等級，給予差異化權益。

---