构建金融级风控中台：Java Spring Boot 集成天远借贷风险探查 API 实战

1. 企业级风控的"最后一块拼图"

在构建企业级信贷审批系统时，后端工程师往往面临双重挑战：既要保证核心链路的高可用性 ，又要处理多源异构数据的安全性。特别是在接入外部征信数据时，如何优雅地将第三方数据"清洗"并融入内部的决策引擎，是系统设计的关键。

天远数据 的金融借贷信用风险探查API（JRZQ2F8A）因其标准化的数据结构和严格的安全机制，常被选为贷前风控的核心数据源。不同于简单的黑名单查询，该接口通过 AES-128 加密传输，返回包含逾期金额区间、履约状况等维度的深度画像，非常适合作为微服务架构中"风控服务"的外部依赖。

本文将从 Java 后端开发的视角，演示如何封装一个线程安全、强类型的 SDK 来对接该接口，实现自动化的风险筛查。

2. API 调用示例：工程化封装

在 Java 环境中，我们通常需要处理并发请求，因此不能简单地写脚本。我们需要构建一个包含加密工具类 、DTO（数据传输对象）和HTTP 客户端的完整调用链。

2.1 接口契约

接口地址 ：https://api.tianyuanapi.com/api/v1/JRZQ2F8A
安全机制：AES-CBC 模式，128位密钥，PKCS7 填充，IV 随机生成并拼接在密文前。

2.2 核心代码实现

为了方便开发者直接使用，我们使用原生 javax.crypto 库实现加密，避免引入过多的第三方依赖。

Step 1: AES 加解密工具类 (Thread-Safe)

Java

jsx 复制代码

import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.security.SecureRandom;
import java.util.Base64;

public class TianyuanCryptoUtils {

    private static final String ALGORITHM = "AES/CBC/PKCS5Padding"; // Java的PKCS5Padding兼容PKCS7

    /**
     * 加密方法：生成IV -> 加密 -> 拼接IV+密文 -> Base64
     */
    public static String encrypt(String rawJson, String accessKey) throws Exception {
        byte[] keyBytes = accessKey.getBytes(StandardCharsets.UTF_8);
        byte[] contentBytes = rawJson.getBytes(StandardCharsets.UTF_8);

        // 1. 生成16字节随机IV
        byte[] ivBytes = new byte[16];
        new SecureRandom().nextBytes(ivBytes);
        IvParameterSpec ivSpec = new IvParameterSpec(ivBytes);
        SecretKeySpec keySpec = new SecretKeySpec(keyBytes, "AES");

        // 2. 执行加密
        Cipher cipher = Cipher.getInstance(ALGORITHM);
        cipher.init(Cipher.ENCRYPT_MODE, keySpec, ivSpec);
        byte[] encryptedBytes = cipher.doFinal(contentBytes);

        // 3. 拼接 IV + 密文
        byte[] combined = new byte[ivBytes.length + encryptedBytes.length];
        System.arraycopy(ivBytes, 0, combined, 0, ivBytes.length);
        System.arraycopy(encryptedBytes, 0, combined, ivBytes.length, encryptedBytes.length);

        // 4. Base64编码
        return Base64.getEncoder().encodeToString(combined);
    }

    /**
     * 解密方法：Base64解码 -> 提取IV -> 解密
     */
    public static String decrypt(String base64Data, String accessKey) throws Exception {
        byte[] keyBytes = accessKey.getBytes(StandardCharsets.UTF_8);
        byte[] combined = Base64.getDecoder().decode(base64Data);

        // 1. 提取前16字节作为IV
        byte[] ivBytes = new byte[16];
        System.arraycopy(combined, 0, ivBytes, 0, 16);
        
        // 2. 提取剩余部分作为密文
        byte[] ciphertext = new byte[combined.length - 16];
        System.arraycopy(combined, 16, ciphertext, 0, ciphertext.length);

        // 3. 执行解密
        IvParameterSpec ivSpec = new IvParameterSpec(ivBytes);
        SecretKeySpec keySpec = new SecretKeySpec(keyBytes, "AES");
        Cipher cipher = Cipher.getInstance(ALGORITHM);
        cipher.init(Cipher.DECRYPT_MODE, keySpec, ivSpec);

        return new String(cipher.doFinal(ciphertext), StandardCharsets.UTF_8);
    }
}

Step 2: 服务层调用逻辑

这里模拟一个 Spring Service 的方法，展示如何组装参数并处理响应。

Java

jsx 复制代码

import com.fasterxml.jackson.databind.ObjectMapper; // 假设使用Jackson处理JSON
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.HashMap;
import java.util.Map;

public class RiskProbeService {

    private static final String API_URL = "https://api.tianyuanapi.com/api/v1/JRZQ2F8A";
    private static final String ACCESS_ID = "Your_Access_Id";
    private static final String ACCESS_KEY = "Your_16_Byte_Key"; // 必须16位
    
    private final HttpClient httpClient = HttpClient.newHttpClient();
    private final ObjectMapper objectMapper = new ObjectMapper();

    public void checkUserRisk(String name, String idCard, String mobile) {
        try {
            // 1. 组装业务参数
            Map<String, String> payload = new HashMap<>();
            payload.put("name", name);
            payload.put("id_card", idCard);
            payload.put("mobile_no", mobile);
            payload.put("authorized", "1"); // 必须获得授权 

            // 2. 加密参数
            String jsonPayload = objectMapper.writeValueAsString(payload);
            String encryptedData = TianyuanCryptoUtils.encrypt(jsonPayload, ACCESS_KEY);

            // 3. 构造请求体 {"data": "..."}
            Map<String, String> requestBodyMap = new HashMap<>();
            requestBodyMap.put("data", encryptedData);
            String requestBody = objectMapper.writeValueAsString(requestBodyMap);

            // 4. 发送 POST 请求 (带时间戳)
            String urlWithTs = API_URL + "?t=" + System.currentTimeMillis();
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(urlWithTs))
                    .header("Content-Type", "application/json")
                    .header("Access-Id", ACCESS_ID) // 必填Header 
                    .POST(HttpRequest.BodyPublishers.ofString(requestBody))
                    .build();

            HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
            
            // 5. 解析响应
            handleResponse(response.body());

        } catch (Exception e) {
            e.printStackTrace(); // 实际项目中建议使用 logger.error
        }
    }

    private void handleResponse(String respJson) throws Exception {
        // 解析外层 JSON
        Map<String, Object> respMap = objectMapper.readValue(respJson, Map.class);
        int code = (int) respMap.get("code");

        if (code == 0) {
            // 业务成功，解密内部 data 数据
            String encryptedData = (String) respMap.get("data");
            String realDataJson = TianyuanCryptoUtils.decrypt(encryptedData, ACCESS_KEY);
            System.out.println("解密后的风控报告: " + realDataJson);
            // 这里可以将 realDataJson 映射为 Java DTO 对象进行业务判断
        } else {
            // 处理业务异常，如余额不足(1007)或参数错误(1003) 
            System.err.println("API Error: " + respMap.get("message"));
        }
    }
}

3. 核心数据结构解析：强类型映射

在 Java 开发中，我们不建议直接操作 Map 或 JSONObject。定义清晰的 POJO (Plain Old Java Object) 有助于后续的维护和规则引擎接入。

根据 天远API 的文档，我们可以构建如下的数据模型：

Java

jsx 复制代码

/**
 * 风险探查结果 DTO
 */
public class RiskReportDTO {
    
    /**
     * 探查结果编码: 1-A(正常画像), 4-U(数据不足), N(查无此人)
     * 业务判断入口字段
     */
    private String result_code; 
    
    /**
     * 最大逾期金额区间，例如 "(1000~2000]"
     * 金额区间映射着违约的严重程度
     */
    private String max_overdue_amt; 
    
    /**
     * 最长逾期天数，例如 "16-30" 或 ">180"
     * 对应M1, M2, M3+等风控术语
     */
    private String max_overdue_days; 
    
    /**
     * 当前逾期机构数 (多头借贷预警)
     * Integer.parseInt(val) > 0 即为高风险
     */
    private String currently_overdue; 
    
    /**
     * 履约机构数 (信用积累指标)
     */
    private String currently_performance;
    
    // Getters and Setters...
}

字段业务逻辑表

字段名	类型	关键值示例	建议 Java 处理逻辑
	`result_code`	String	`1`, `4`, `N`
`max_overdue_days`	String	`>180`	此值为"黑名单"级信号，建议在 Drools 或规则引擎中设为 `Reject`。
`acc_sleep`	String	`14`	睡眠机构数。高数值可能意味着用户曾在多家平台注册但未活跃，属于沉睡户。

4. 应用价值分析：架构师视角

将金融借贷信用风险探查API 集成到系统中，不仅仅是一次 HTTP 请求，而是构建自动化信贷决策引擎的基础。

4.1 嵌入微服务网关

在 Spring Cloud 架构中，可以将此 API 封装为独立的"征信数据服务（Credit Data Service）"。

输入：用户三要素（姓名、手机、身份证）。
输出：标准化信用评分（根据天远返回的区间自定义计算）。
价值：实现数据源与业务逻辑解耦。如果未来更换数据源，上层业务无感知。

4.2 决策树应用

在实际业务中，可以根据返回字段构建简单的决策树：

准入校验：
- result_code == N ? -> 转人工核实（可能为新号或录入错误）。
红线过滤：
- currently_overdue > 0 ? -> 直接拒绝。
- max_overdue_days 包含 >180 或 91-120 ? -> 直接拒绝。

额度定级：

currently_performance > 5 且无逾期 -> A级用户（高额度）。

复制代码

 `max_overdue_amt` 在 `(1~1000]` 之间（小额逾期） -> **B级用户（降额通过）**。

5. 总结

通过本文的 Java 实战代码，我们可以看到，天远API 的设计非常符合企业级开发规范：

安全性高：AES-128 + 动态 IV 机制，有效防止了中间人攻击和数据泄露。
结构清晰：返回数据将复杂的借贷行为抽象为"区间"和"编码"，极大地降低了后端解析和存储的成本。

开发建议：

建议使用 Redis 缓存 API 响应结果（例如缓存 24 小时），因为用户的信用画像短时间内不会剧烈突变，这样可以节省调用费用。
生产环境中务必妥善保管 Access-Id 和 Access-Key，建议存储在 Nacos 或 Apollo 配置中心，禁止硬编码。