车辆资产核验实战：天远名下车辆车牌查询API接口调用代码与场景分析一、车辆资产确权的核心数据支撑在ETC线上发行、智

一、车辆资产确权的核心数据支撑

在ETC线上发行、智慧停车管理、汽车金融风控以及企业资产盘点等众多场景中，快速验证个人名下持有的车辆信息是业务开展的关键环节。[名下车辆车牌查询]API，能够依据用户的姓名和身份证号，对接国家部委权威数据库，精准返回其名下车辆的数量、车牌号及车辆类型等关键资产信息。

天远API 提供的这项服务以数据更新及时、合法合规著称，解决了传统线下车管核验效率低、成本高的问题。本文将作为一份详细的开发文档，深入剖析此API，详细解读其返回的原始数据结构和每一个核心字段的含义，帮助开发者利用 Python 语言高效接入天远API，利用权威数据赋能车务管理与风险控制业务。

二、 API接口调用示例

本节将详细展示如何通过代码接入天远API的名下车辆车牌查询服务。该接口采用AES-128加密传输，确保用户隐私数据（如身份证号）在传输过程中的绝对安全。

1. 调用说明

接口地址：https://api.tianyuanapi.com/api/v1/QCXG3G8K?t=13位时间戳
请求方式：POST
安全机制：
- 请求头需携带 Access-Id。
- 请求体参数（身份证、姓名）需进行 AES-128-CBC 加密，并进行 Base64 编码。
- 响应数据同样为加密字符串，需解密后查看。

2. Curl 调用示例

Bash

# 注意：data字段的内容是经过AES加密并Base64编码后的JSON字符串
# 原始JSON包含: {"id_card": "320xxxxxxxx", "name": "张三"}

curl -X POST "<https://api.tianyuanapi.com/api/v1/QCXG3G8K?t=1715678901234>" \
     -H "Content-Type: application/json" \
     -H "Access-Id: YOUR_ACCESS_ID" \
     -d '{
           "data": "U2FsdGVkX1+..." 
         }'

3. Python Requests 调用完整示例

以下代码展示了完整的调用流程。为了便于集成，代码中包含加密解密逻辑的占位符，实际开发中请参照标准AES-128-CBC模式（PKCS7填充）实现。

Python

import requests
import json
import time
import base64
# 需引入加密库，例如: from Crypto.Cipher import AES

# --- 配置项 ---
API_URL = "<https://api.tianyuanapi.com/api/v1/QCXG3G8K>"
ACCESS_ID = "您的Access-Id"
ACCESS_KEY = "您的Access-Key (16进制字符串)" 

# --- 模拟加密解密工具函数 (请替换为标准AES-128-CBC实现) ---
def encrypt_data(data_dict, key):
    """
    1. 生成随机16字节IV
    2. 使用AES-CBC模式加密JSON字符串 (PKCS7填充)
    3. 拼接 IV + 密文
    4. 返回 Base64 编码字符串
    """
    # TODO: 开发者需在此处实现AES加密
    json_str = json.dumps(data_dict)
    print(f"[Debug] 正在加密参数: {json_str}...") 
    return "Base64_Encrypted_String_Placeholder"

def decrypt_data(base64_str, key):
    """
    1. Base64解码
    2. 提取前16字节 IV
    3. 解密剩余密文
    4. 去除填充，返回明文对象
    """
    # TODO: 开发者需在此处实现AES解密
    # 模拟返回解密后的数据
    return {
        "vehicleCount": "1",
        "list": [
            {
                "plateNum": "京A88888",
                "plateColor": 0,
                "vehicleType": 1
            }
        ]
    }

# --- 主调用逻辑 ---
def query_user_vehicles(id_card, real_name):
    # 1. 构造时间戳
    timestamp = str(int(time.time() * 1000))
    url = f"{API_URL}?t={timestamp}"
    
    # 2. 构造原始请求参数
    payload_raw = {
        "id_card": id_card,
        "name": real_name
    }
    
    try:
        # 3. 加密参数
        encrypted_data = encrypt_data(payload_raw, ACCESS_KEY)
        
        # 4. 发送请求
        headers = {
            "Access-Id": ACCESS_ID,
            "Content-Type": "application/json"
        }
        body = {"data": encrypted_data}
        
        print(f"正在请求天远API: {url}")
        response = requests.post(url, headers=headers, json=body, timeout=10)
        
        # 5. 处理响应
        if response.status_code == 200:
            res_json = response.json()
            # 响应结构: {code, message, transaction_id, data}
            if res_json.get("code") == 200 and res_json.get("data"):
                # 解密响应数据
                decrypted_info = decrypt_data(res_json["data"], ACCESS_KEY)
                print("\n=== 查询成功，名下车辆信息如下 ===")
                print(json.dumps(decrypted_info, indent=2, ensure_ascii=False))
                return decrypted_info
            else:
                print(f"业务请求失败: {res_json.get('message')}")
        else:
            print(f"HTTP错误: {response.status_code}")
            
    except Exception as e:
        print(f"发生异常: {str(e)}")

# --- 执行测试 ---
if __name__ == "__main__":
    # 示例数据
    id_card_input = "11010119900101xxxx"
    name_input = "张三"
    
    query_user_vehicles(id_card_input, name_input)

三、核心数据结构解析

天远API 返回的数据结构非常精简高效，解密后的 data 主要由两部分组成：车辆总数统计和详细车辆列表。

vehicleCount (车辆统计) ：快速判断用户是否拥有车辆，适用于简单的布尔逻辑判断（如：是否有车）。
list (车辆明细列表) ：数组结构，包含每一辆车的具体信息。如果用户有多辆车，该数组将返回多条记录 1。
- plateNum：车牌号码，业务核心标识。
- plateColor：车牌颜色代码，用于区分燃油车、新能源车或大型车辆。
- vehicleType：车辆类型代码，用于区分客车、货车或专项作业车。

四、字段详解

为了方便开发者进行业务逻辑映射，以下表格详细列出了返回参数及其对应的枚举值说明。

1. 基础返回参数

字段名	参数命名	类型	说明
车辆数	vehicleCount	String	名下车辆总数量
车辆列表	list	List	包含所有车辆信息的数组
车牌号	plateNum	String	完整的车牌号码（如：京A88888）

2. 车牌颜色代码表 (plateColor)

通过颜色可快速区分车辆属性（如 11=绿色代表新能源车）2。

Code	颜色/类型描述	常见场景
0	蓝色	普通小型燃油客车
1	黄色	大型车辆、摩托车、教练车
2	黑色	外籍/港澳入出境车辆
3	白色	警车、军车等特种车
11	绿色	新能源小客车
12	红色	临时/特殊号牌
5	黄绿双拼色	大型新能源汽车

3. 车辆类型代码表 (vehicleType)

用于判断车辆是用于载客还是运输，通过 Type 1-4 区分收费车型 3。

Code	类型描述	Code	类型描述
1	一型客车 (≤9座)	11	一型货车
2	二型客车 (10-19座)	12	二型货车
3	三型客车 (20-39座)	13	三型货车
4	四型客车 (≥40座)	14	四型货车
21	一型专项作业车	22	二型专项作业车

五、应用价值分析

通过集成天远API的名下车辆查询功能，企业可以在以下具体场景中提升业务效能：

ETC发行与通行管理：

在ETC线上办理流程中，用户输入身份证号后，系统调用API自动拉取名下 plateNum（车牌号）和 vehicleType（车辆类型），自动填充表单并核验车型（如区分一型客车与二型客车），减少用户录入错误，提升通过率。
智慧停车与物业管理：

高端社区或办公园区在业主车辆登记时，通过API验证申报车辆是否真属于业主名下（车主姓名与业主身份证一致），有效防止外来车辆冒充业主车辆占用车位资源。
汽车金融与信贷风控：

在信贷审批环节，查询申请人名下 vehicleCount。若显示名下有多辆 plateColor=1（黄色牌照）的货车，可推断申请人可能从事物流运输行业，从而更精准地评估其资产状况和还款能力。
物流司机背景核查：

物流平台招募自带车司机时，利用该接口核验司机提供的车牌是否在自己名下，通过 plateColor 确认车辆是否为合规的营运车辆（如排除私家车非法运营），保障平台合规性。

六、总结

天远名下车辆车牌查询API 是一项连接权威数据源的高质量服务，它以极简的输入（身份证+姓名）换取了高价值的资产信息。对于开发者而言，其标准的 JSON 数据结构和详细的枚举定义（车牌颜色、车型），极大降低了系统对接的复杂度。

通过接入API，企业不仅能实现车辆资产的毫秒级核验，还能基于数据构建更严密的风控模型。建议开发者在对接时，特别注意对 vehicleType 的业务映射，以便在差异化收费或车型限制场景中发挥最大价值。

车辆资产核验实战：天远名下车辆车牌查询API接口调用代码与场景分析

一、 车辆资产确权的核心数据支撑