信用评分API对接实战｜基于天远API的个人信用分接口完整调用流程与应用案例

天远API
79 阅读5分钟

一、个人信用分API

在金融信贷风险评估、互联网消费分期、在线租赁风控、招聘背景调查以及电子商务反欺诈等众多场景中，信用分评估是衡量用户风险等级与信用状况的关键依据。

个人信用分API 由 天远API 提供，基于多头趋势分布、借贷行为、社交数据、流量特征、设备画像等多维度AI机器学习模型，输出综合信用评分（300–900分）。

该接口帮助企业通过算法识别高风险客户，实现精准拦截与信贷决策智能化。

本文将作为一份完整的开发文档，详细解读 个人信用分API 的调用流程、参数加密机制、数据结构与字段说明，协助开发者快速完成集成与业务应用。

二、API接口调用示例

1. 调用说明

  • 接口地址：https://api.tianyuanapi.com/api/v1/JRZQ0L85?t=13位时间戳

  • 请求方式：POST

  • 请求头参数：

    • Access-Id：用于身份验证的账号ID
    • Content-Type：application/json

请求参数需通过 AES-128-CBC 模式加密后进行 Base64 编码，加密后内容放入字段 data 中。

每次调用都需携带有效的 Access-Id，并保证密钥安全。

2. cURL 调用示例

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": "张三"
}

3. Python 调用示例

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响应结构包含三层：

  1. 基础响应层：包括 code、message、transaction_id，用于标识调用状态与流水号。
  2. 业务数据层：data字段为加密的业务内容，需使用AES解密后解析。
  3. 结果字段层：解密后包含 score_120_General，表示用户综合信用分。

数据层级结构：

{
  "code": 0,
  "message": "业务成功",
  "transaction_id": "20251102123456789",
  "data": {
    "score_120_General": "480"
  }
}

四、字段详解

（1）请求参数说明

字段名含义说明
mobile_no手机号用户注册手机号
id_card身份证号用户身份证号码
name姓名用户真实姓名

（2）响应参数说明

字段名含义说明
code状态码0 表示成功，其它为错误
message返回信息接口调用返回的状态描述
transaction_id流水号本次调用的唯一标识
data加密数据需解密后查看明文内容

（3）业务数据字段

字段名含义说明
score_120_General综合信用分取值范围300–900；分数越高代表风险越低；为-1时表示未命中

（4）错误码说明

codemessage说明
0业务成功调用成功返回结果
1000查询为空未查询到结果
1001接口异常系统内部错误
1002参数解密失败data参数解析错误
1003基础参数校验不正确缺少必要字段或格式错误
1004未经授权的IP当前IP未加入白名单
1005缺少Access-Id未传入认证头信息
1006未经授权的AccessId认证ID无效
1007账户余额不足需充值后继续使用
1008未开通此产品未授权访问该API
2001业务失败调用失败

五、应用价值分析

个人信用分API 由 天远API 提供，基于AI风控建模与大数据计算，为企业提供以下核心价值：

  1. 金融信贷风控：用于贷款审批、信用卡发放、消费分期风控等场景，有效识别潜在高风险客户。
  2. 电商与租赁平台：评估用户履约能力，防止恶意下单或拖欠。
  3. 企业风控系统集成：可嵌入CRM、ERP、SaaS风控模块，实现自动化决策流。
  4. 数据分析优化：结合用户画像与交易行为，进一步优化评分阈值策略（如：450以下拒绝、650以上通过）。
  5. 社交与行为信用评估：结合设备、网络与社交数据，辅助构建更精准的个人信用画像。

个人信用分API 是一款覆盖多维度数据源、支持安全加密传输的高可靠性接口，特别适合需要高精度信用风险评估的企业使用。

通过简单的POST请求与AES加密机制，开发者即可安全集成信用评分功能，实现数据驱动的信贷决策、用户准入和风险拦截。

对于想要构建智能风控系统的开发团队而言，该API不仅能节省建模成本，还能直接接入权威评分数据，快速完成从数据采集到风险判断的全流程自动化。

avatar
文章
阅读
粉丝