首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >API:个人信用分API接口接入方法与加密调用流程全解析

API:个人信用分API接口接入方法与加密调用流程全解析

作者头像
用户11800419
修改2025-11-02 14:08:04
修改2025-11-02 14:08:04
1090
举报

一、个人信用分API

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

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

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

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


二、API接口调用示例

1. 调用说明

  • 接口地址https://api.tianyuanapi.com/api/v1/JRZQ0L85?t=13位时间戳
  • 请求方式POST
  • 请求头参数
    • Access-Id:用于身份验证的账号ID
    • Content-Typeapplication/json

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

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


2. cURL 调用示例

代码语言:bash
复制
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 由以下原始参数加密得到:

代码语言:json
复制
{
  "mobile_no": "13800001111",
  "id_card": "110101199001012345",
  "name": "张三"
}

3. Python 调用示例

代码语言: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. 基础响应层:包括 codemessagetransaction_id,用于标识调用状态与流水号。
  2. 业务数据层data字段为加密的业务内容,需使用AES解密后解析。
  3. 结果字段层:解密后包含 score_120_General,表示用户综合信用分。

数据层级结构:

代码语言:json
复制
{
  "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)错误码说明

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 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、个人信用分API
  • 二、API接口调用示例
    • 1. 调用说明
    • 2. cURL 调用示例
    • 3. Python 调用示例
  • 三、核心数据结构解析
  • 四、字段详解
    • (1)请求参数说明
    • (2)响应参数说明
    • (3)业务数据字段
    • (4)错误码说明
  • 五、应用价值分析
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档