零信任架构实战：基于天远柠檬查出险-登记证API构建自动化车辆履约评估网关

破解车辆资信核查难题：从传统人工核查到数据直连

在二手车交易、汽车金融租凭、车辆抵押评估以及车险履约等业务场景中，快速确认目标车辆的历史出险状况与登记证一致性，是防范车辆资信隐患、保障交易顺畅运行的关键环节。传统核查模式往往依赖人工收集纸质登记证照片并前往线下机构窗口核验，这种人工盲审模式不仅流转周期长、影响买卖双方交易体验，且信息传递存在滞后风险，难以满足高频汽车金融业务的在线及时性要求。

天远柠檬查出险-登记证API为汽车服务系统提供了一套标准化的数据直连方案。在获取车主明确授权的前提下，系统只需向接口传入车架号 vin、登记证远程图片地址 img_url、业务订单号 out_order_no 与异步通知地址 notify_url，即可直连权威数据库发起异步查询。在接收到回调通知后，系统解密数据即可提取报告链接地址 reportUrl，快速调取该车辆的出险与登记履约报告。

这种系统直连的数据穿透能力，使得将"车辆资信合规审查"这一动作无缝嵌入到二手车在线评估、汽车金融自动化放款或抵押物实时巡检流程中成为可能，助推业务实现前置自动化校验与高质高效运行。

Java 加密通信集成：构建高可用审核管道

本接口在设计上强制要求对业务负载（Payload）进行加密传输，使用 AES-128-CBC 加密算法。以下展示如何在 Java 中构建标准的请求与解密客户端。

1. 核心参数与加密配置

接口地址 : https://api.tianyuanapi.com/api/v1/QCXGD3R8 (需在 URL 附加 ?t=13位时间戳)
请求方式 : POST
请求头 :
- Access-Id: 账号的 Access-Id (必填)
- Content-Type: application/json
关键入参 :
- vin: 车架号码（必填）
- img_url: 登记证远程图片地址（必填）
- out_order_no: 用户自定义业务订单号（必填）
- notify_url: 异步通知地址（必填）
鉴权与加密机制 : 使用账户的 16 进制 Access Key 作为密钥，采用 AES-128 算法的 CBC 模式。每次请求动态生成 16 字节 IV 并配合 PKCS7 填充，最终将 IV 与密文拼接后进行 Base64 编码放入请求体 data 字段中。

2. 标准化调用代码 (Java)

java 复制代码

package com.tianyuan.api.client;

import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.security.SecureRandom;
import java.util.Base64;

public class TianyuanVehicleJavaClient {

    private static final String BASE_URL = "https://api.tianyuanapi.com/api/v1/QCXGD3R8";
    private final String accessId;
    private final byte[] accessKeyBytes;

    public TianyuanVehicleJavaClient(String accessId, String accessKeyHex) {
        this.accessId = accessId;
        this.accessKeyBytes = hexStringToByteArray(accessKeyHex);
        if (this.accessKeyBytes.length != 16) {
            throw new IllegalArgumentException("Access Key 必须为 16 字节");
        }
    }

    private static byte[] hexStringToByteArray(String s) {
        int len = s.length();
        byte[] data = new byte[len / 2];
        for (int i = 0; i < len; i += 2) {
            data[i / 2] = (byte) ((Character.digit(s.charAt(i), 16) << 4)
                                 + Character.digit(s.charAt(i+1), 16));
        }
        return data;
    }

    private String encrypt(String rawJson) throws Exception {
        byte[] iv = new byte[16];
        new SecureRandom().nextBytes(iv);
        IvParameterSpec ivSpec = new IvParameterSpec(iv);
        SecretKeySpec skeySpec = new SecretKeySpec(this.accessKeyBytes, "AES");

        Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
        cipher.init(Cipher.ENCRYPT_MODE, skeySpec, ivSpec);
        byte[] encrypted = cipher.doFinal(rawJson.getBytes("UTF-8"));

        byte[] combined = new byte[iv.length + encrypted.length];
        System.arraycopy(iv, 0, combined, 0, iv.length);
        System.arraycopy(encrypted, 0, combined, iv.length, encrypted.length);

        return Base64.getEncoder().encodeToString(combined);
    }

    public String executeQuery(String vin, String imgUrl, String outOrderNo, String notifyUrl) throws Exception {
        long timestamp = System.currentTimeMillis();
        String fullUrl = BASE_URL + "?t=" + timestamp;

        String jsonParams = String.format("{\"vin\":\"%s\",\"img_url\":\"%s\",\"out_order_no\":\"%s\",\"notify_url\":\"%s\"}", vin, imgUrl, outOrderNo, notifyUrl);
        String encryptedData = encrypt(jsonParams);
        String requestBody = "{\"data\":\"" + encryptedData + "\"}";

        URL url = new URL(fullUrl);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Access-Id", this.accessId);
        conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
        conn.setDoOutput(true);
        conn.setConnectTimeout(5000);
        conn.setReadTimeout(10000);

        try (OutputStream os = conn.getOutputStream()) {
            byte[] input = requestBody.getBytes("UTF-8");
            os.write(input, 0, input.length);
        }

        try (BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"))) {
            StringBuilder response = new StringBuilder();
            String responseLine;
            while ((responseLine = br.readLine()) != null) {
                response.append(responseLine.trim());
            }
            return response.toString();
        }
    }

    public static void main(String[] args) throws Exception {
        TianyuanVehicleJavaClient client = new TianyuanVehicleJavaClient("YOUR_ACCESS_ID", "0123456789abcdef0123456789abcdef");
        String resp = client.executeQuery("LFV1234567890ABCD", "https://example.com/djz.jpg", "ORD20260807001", "https://your.domain/callback");
        System.out.println("服务端响应: " + resp);
    }
}

3. 终端快捷验证 (cURL)

bash 复制代码

curl -X POST "https://api.tianyuanapi.com/api/v1/QCXGD3R8?t=1710748432000" \
     -H "Access-Id: YOUR_ACCESS_ID" \
     -H "Content-Type: application/json" \
     -d '{"data": "预先生成的加密Base64字符串"}'

核心车辆资信数据解析与业务映射

参数代码	字段说明	数据类型	开发者注意 (业务映射建议)
out_order_no	业务订单号	STRING	关联标识。用于异步回调逻辑匹配。
reportUrl	报告链接地址	STRING	核心报告文件。用于在前端展示评估详情。

场景化应用：让核验数据赋能合规闭环

二手车在线交易平台的车辆资信自动审核：卖家上传登记证照片，平台自动发起异步请求，解密报告建立认证。
汽车金融租赁资信评估与放款前置确认 ：调取 reportUrl 中的履约报告进行核实。

生产环境接入的安全与合规边界

授权基础：务必确保已获取明确授权。
密文传输：通信层强制采用 AES-128-CBC 动态加密。
权限隔离：在网关层配置限流策略。