Node.js全栈实战：基于天远名下车辆数量查询API实现的智能资产核验组件

解决"端到端"资产核验的安全悖论

在开发涉及个人资产核验（如车贷申请、保险试算、车主认证）的 H5 或小程序时，前端开发者往往面临一个尴尬的局面：业务需要实时校验用户是否拥有车辆，但直接在浏览器或客户端调用第三方 API 会暴露极其敏感的 Access Key 和加密算法，带来严重的安全隐患。

天远名下车辆数量查询 API 提供了权威的车辆资产验证能力，通过"姓名+身份证+手机号"三要素，毫秒级返回用户及其名下车辆的详细信息。为了兼顾数据安全与用户体验，最佳实践是利用 Node.js 搭建一个轻量级的 BFF 层（Backend for Frontend）或部署为 Serverless 云函数。这样既能在服务端完成高强度的 AES 加密，又能为前端提供经过裁剪和格式化的"前端友好型"数据。

Node.js 中间件集成实战

本节演示如何使用 Node.js 原生 crypto 模块和 axios 库，构建一个安全的 API 转发服务。该服务将负责处理 天远名下车辆数量查询 接口所要求的 AES-128-CBC 加密逻辑，确保敏感密钥绝不泄露给客户端。

开发环境配置

运行环境: Node.js (v14+)
接口地址 : https://api.tianyuanapi.com/api/v1/QCXG4T6Q
依赖库 : axios

核心代码实现

JavaScript

jsx 复制代码

const axios = require('axios');
const crypto = require('crypto');

// 配置信息（建议存储在环境变量中）
const CONFIG = {
    apiUrl: 'https://api.tianyuanapi.com/api/v1/QCXG4T6Q',
    accessId: process.env.TIANYUAN_ACCESS_ID || 'YOUR_ACCESS_ID',
    accessKey: process.env.TIANYUAN_ACCESS_KEY || 'YOUR_ACCESS_KEY_HEX' // 16进制字符串
};

/**
 * AES-128-CBC 加密工具函数
 * 符合接口要求：AES-CBC + PKCS7 Padding + 随机IV + Base64
 */
function encryptData(payload, keyHex) {
    const key = Buffer.from(keyHex, 'utf8'); // 实际使用请确认Key的编码格式
    const iv = crypto.randomBytes(16);       // 生成随机16字节IV
    const plaintext = JSON.stringify(payload);

    const cipher = crypto.createCipheriv('aes-128-cbc', key, iv);
    let encrypted = cipher.update(plaintext, 'utf8');
    encrypted = Buffer.concat([encrypted, cipher.final()]);

    // 拼接 IV + 密文 -> Base64
    const combined = Buffer.concat([iv, encrypted]);
    return combined.toString('base64');
}

/**
 * AES-128-CBC 解密工具函数
 */
function decryptData(encryptedBase64, keyHex) {
    const key = Buffer.from(keyHex, 'utf8');
    const combined = Buffer.from(encryptedBase64, 'base64');

    // 提取 IV (前16字节) 和 密文
    const iv = combined.slice(0, 16);
    const ciphertext = combined.slice(16);

    const decipher = crypto.createDecipheriv('aes-128-cbc', key, iv);
    let decrypted = decipher.update(ciphertext);
    decrypted = Buffer.concat([decrypted, decipher.final()]);

    return JSON.parse(decrypted.toString('utf8'));
}

/**
 * 业务服务：查询用户车辆资产
 * @param {Object} userInfo - { name, idCard, mobile }
 */
async function queryUserVehicles(userInfo) {
    try {
        // 1. 构造原始请求体
        const payload = {
            "name": userInfo.name,
            "id_card": userInfo.idCard,
            "mobile_no": userInfo.mobile
        };

        // 2. 加密数据
        const encryptedData = encryptData(payload, CONFIG.accessKey);

        // 3. 发起请求 (添加时间戳防止重放)
        const timestamp = Date.now();
        const response = await axios.post(
            `${CONFIG.apiUrl}?t=${timestamp}`,
            { data: encryptedData },
            {
                headers: {
                    'Access-Id': CONFIG.accessId,
                    'Content-Type': 'application/json'
                },
                timeout: 5000 // 5秒超时设置
            }
        );

        const resBody = response.data;

        // 4. 处理响应
        if (resBody.code === 0) {
            // 业务成功，解密数据
            const result = decryptData(resBody.data, CONFIG.accessKey);
            console.log('车辆查询成功:', result);
            return result;
        } else {
            // 处理业务错误（如余额不足 1007）
            console.warn(`API调用失败: [${resBody.code}] ${resBody.message}`);
            return null; // 或抛出自定义异常
        }

    } catch (error) {
        console.error('系统级异常:', error.message);
        throw error;
    }
}

// 模拟调用 (通常在 Controller 或 GraphQL Resolver 中调用)
queryUserVehicles({
    name: '王五',
    idCard: '3101011980xxxx',
    mobile: '1391234xxxx'
});

数据字段的前端映射策略

Node.js 中间件的一个重要职责是数据清洗。天远名下车辆数量查询 API 返回的数据包含状态码和枚举值，直接传给前端会导致逻辑分散。建议在 Node 层将这些"数据字典"转换为"前端组件状态"。

以下是核心字段的映射建议 3：

原始字段	原始值示例	转换后的前端字段	处理逻辑与建议 (Developer Notes)
`vehicleCount`	`"1"` (String)	`hasCar` (Boolean)	建议转换为布尔值用于 UI 开关控制（如显示/隐藏"车辆详情"表单块）。
`plateColor`	`0` (蓝色)	`tagType` (String)	映射为 UI 组件库的 Tag 颜色。如 `0` -> `primary` (蓝牌), `11` -> `success` (绿牌/新能源)。
`vehicleType`	`1` (一型客车)	`iconName` (String)	映射为图标名称。如 `1` -> `icon-car-sedan` (轿车), `11` -> `icon-truck` (货车)。
`plateNum`	`"苏UC037G"`	`displayPlate` (String)	进行脱敏处理（如 `苏U***7G`）后再下发给前端，除非业务明确需要展示明文。

场景化应用：从验证到服务

利用 Node.js 的灵活性，我们可以将 天远名下车辆数量查询 接口封装成多种业务微服务：

智慧社区的访客自助登记

在开发小区访客小程序时，访客输入姓名和手机号，Node.js 后端静默调用该接口。
- 逻辑：如果返回 vehicleCount > 0 且包含该访客所填车牌，系统自动发放"车辆临时通行证"二维码。
- 价值：实现"秒级通关"，避免保安人工核对行驶证的繁琐流程。
网约车司机入驻的 OCR 辅助校验

司机上传行驶证照片进行 OCR 识别后，后端调用此接口进行二次验真。
- 逻辑：比对 OCR 识别出的车牌/车型与 API 返回的官方数据是否一致。
- 价值：有效防止司机使用假证或套牌车注册，保障平台合规性。
车险报价的"猜你喜欢"

在用户进入保险商城时，基于其留存的身份信息预查询车辆状况。
- 逻辑：若接口返回 plateColor: 11 (新能源)，前端自动置顶"新能源专属车险"广告位。
- 价值：通过数据洞察实现千人千面的精准营销，提升点击转化率。

结语

通过 Node.js 对接 天远名下车辆数量查询 API，我们不仅解决了一个技术上的加密通信问题，更是在前后端分离的架构中，安全地引入了权威的数据校验能力。建议开发者在 BFF 层引入 Redis 缓存，对同一用户的查询结果缓存 24 小时，既能节省 API 调用成本，又能显著提升用户体验。