在金融信贷风险评估、互联网消费分期、在线租赁风控、招聘背景调查以及电子商务反欺诈等众多场景中,信用分评估是衡量用户风险等级与信用状况的关键依据。
个人信用分API 基于多头趋势分布、借贷行为、社交数据、流量特征、设备画像等多维度AI机器学习模型,输出综合信用评分(300–900分)。
该接口帮助企业通过算法识别高风险客户,实现精准拦截与信贷决策智能化。
本文将作为一份完整的开发文档,详细解读 个人信用分API 的调用流程、参数加密机制、数据结构与字段说明,协助开发者快速完成集成与业务应用。
https://api.tianyuanapi.com/api/v1/JRZQ0L85?t=13位时间戳POSTAccess-Id:用于身份验证的账号IDContent-Type:application/json请求参数需通过 AES-128-CBC 模式加密后进行 Base64 编码,加密后内容放入字段 data 中。
每次调用都需携带有效的 Access-Id,并保证密钥安全。
curl -X POST "https://api.tianyuanapi.com/api/v1/JRZQ0L85?t=1730457600000" \
-H "Content-Type: application/json" \
-H "Access-Id: your_access_id_here" \
-d '{
"data": "Base64EncodedEncryptedDataHere"
}'其中 Base64EncodedEncryptedDataHere 由以下原始参数加密得到:
{
"mobile_no": "13800001111",
"id_card": "110101199001012345",
"name": "张三"
}import requests
import base64
from Crypto.Cipher import AES
from Crypto.Util.Padding import pad, unpad
import os
import json
import time
# ==========================
# AES加密占位函数
# ==========================
def encrypt_data(data, access_key):
"""
使用AES-128-CBC加密请求数据
:param data: 字典形式的请求参数
:param access_key: 16字节密钥(Access Key)
:return: Base64编码后的字符串
"""
json_data = json.dumps(data, ensure_ascii=False).encode('utf-8')
iv = os.urandom(16) # 随机IV
cipher = AES.new(access_key.encode('utf-8'), AES.MODE_CBC, iv)
encrypted = cipher.encrypt(pad(json_data, AES.block_size))
encrypted_with_iv = iv + encrypted
return base64.b64encode(encrypted_with_iv).decode('utf-8')
# ==========================
# AES解密占位函数
# ==========================
def decrypt_data(encrypted_data, access_key):
"""
解密Base64加密响应数据
"""
data_bytes = base64.b64decode(encrypted_data)
iv = data_bytes[:16]
cipher_text = data_bytes[16:]
cipher = AES.new(access_key.encode('utf-8'), AES.MODE_CBC, iv)
decrypted = unpad(cipher.decrypt(cipher_text), AES.block_size)
return decrypted.decode('utf-8')
# ==========================
# 调用接口
# ==========================
def call_credit_score_api():
url = f"https://api.tianyuanapi.com/api/v1/JRZQ0L85?t={int(time.time()*1000)}"
headers = {
"Access-Id": "your_access_id_here",
"Content-Type": "application/json"
}
access_key = "your_16byte_key"
# 原始参数
payload = {
"mobile_no": "13800001111",
"id_card": "110101199001012345",
"name": "张三"
}
try:
encrypted_data = encrypt_data(payload, access_key)
response = requests.post(url, headers=headers, json={"data": encrypted_data})
response_json = response.json()
if response_json.get("code") == 0:
decrypted_data = decrypt_data(response_json["data"], access_key)
print("解密结果:", decrypted_data)
else:
print("接口调用失败:", response_json.get("message"))
except Exception as e:
print("调用异常:", str(e))
# 运行调用
if __name__ == "__main__":
call_credit_score_api()API响应结构包含三层:
code、message、transaction_id,用于标识调用状态与流水号。data字段为加密的业务内容,需使用AES解密后解析。score_120_General,表示用户综合信用分。数据层级结构:
{
"code": 0,
"message": "业务成功",
"transaction_id": "20251102123456789",
"data": {
"score_120_General": "480"
}
}字段名 | 含义 | 说明 |
|---|---|---|
mobile_no | 手机号 | 用户注册手机号 |
id_card | 身份证号 | 用户身份证号码 |
name | 姓名 | 用户真实姓名 |
字段名 | 含义 | 说明 |
|---|---|---|
code | 状态码 | 0 表示成功,其它为错误 |
message | 返回信息 | 接口调用返回的状态描述 |
transaction_id | 流水号 | 本次调用的唯一标识 |
data | 加密数据 | 需解密后查看明文内容 |
字段名 | 含义 | 说明 |
|---|---|---|
score_120_General | 综合信用分 | 取值范围300–900;分数越高代表风险越低;为-1时表示未命中 |
code | message | 说明 |
|---|---|---|
0 | 业务成功 | 调用成功返回结果 |
1000 | 查询为空 | 未查询到结果 |
1001 | 接口异常 | 系统内部错误 |
1002 | 参数解密失败 | data参数解析错误 |
1003 | 基础参数校验不正确 | 缺少必要字段或格式错误 |
1004 | 未经授权的IP | 当前IP未加入白名单 |
1005 | 缺少Access-Id | 未传入认证头信息 |
1006 | 未经授权的AccessId | 认证ID无效 |
1007 | 账户余额不足 | 需充值后继续使用 |
1008 | 未开通此产品 | 未授权访问该API |
2001 | 业务失败 | 调用失败 |
个人信用分API 是一款覆盖多维度数据源、支持安全加密传输的高可靠性接口,特别适合需要高精度信用风险评估的企业使用。
通过简单的POST请求与AES加密机制,开发者即可安全集成信用评分功能,实现数据驱动的信贷决策、用户准入和风险拦截。
对于想要构建智能风控系统的开发团队而言,该API不仅能节省建模成本,还能直接接入权威评分数据,快速完成从数据采集到风险判断的全流程自动化。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。