VIN车架号新能源电池参数查询API｜字段解析与Python接入示例
## 一、业务背景 国内新能源汽车保有量持续上涨，不少B端系统需要根据车架号自动带出电池相关信息： - 二手车平台展示电池配置，辅助车辆估值； - 保险系统承保时采集电池规格，出险后定损比对原厂参数； - 汽修汽配系统根据VIN匹配电芯、电池包、BMS原厂配件型号。 这类场景只需要车辆出厂公告的固定配置，不需要车载BMS实时检测数据，就可以使用本接口快速完成数据补全。 >⚠️ 重要提示：接口为**静态出厂档案**，无SOH、压差、循环次数等动态数据，不可用于电池衰减评估。 ## 二、接口简介 传入17位标准VIN车架号，即可获取车辆基础信息、整车尺寸重量、电芯参数、电池包PACK参数、BMS厂商信息，数据源每日更新。 详见 ### 返回字段总表 |名称|类型|说明| |:-:|:-:|:-:| |vin|string|车架号| |brand_name|string|品牌| |manufacturer|string|车辆生产企业| |rlxs|string|动力类型| |scale|string|车辆类别| |driving_condition|string|标称续航（km）| |full_weight|string|整备质量（kg）| |full_weight_max|string|总质量（kg）| |len|string|外形尺寸长（mm）| |width|string|外形尺寸宽（mm）| |height|string|外形尺寸高（mm）| |cell_type|string|电芯类型| |cell_supplier|string|电芯供应商| |cell_code|string|电芯型号| |cell_shape|string|电芯形状| |cell_size|string|电芯尺寸（mm）| |cell_voltage|string|电芯电压(V)| |cell_capacity|string|电芯容量(Ah)| |cell_count|string|电芯数量（个）| |cell_mass|string|电芯重量(kg)| |cell_gravimetric_energy_density|string|电芯重量能量密度(Wh/kg)| |batt_pack_supplier|string|电池包供应商| |batt_pack_capacity|string|标称容量(Ah)| |batt_pack_voltage|string|电池包标称电压(V)| |batt_pack_quantity|string|电池包电量，标称能量(kWh)| |batt_pack_mass|string|整车电池包重量(kg)| |batt_pack_density|string|电池包能量密度范围(Wh/kg)| |batt_pack_combon|string|电池包组合方式| |bms_supplier|string|BMS生产企业| ## 三、返回数据详解 返回JSON分为五大模块，下面附带样例与业务重点字段解读。 ### 1. 车辆基础信息 ``` { "vin": "LC0C74C4XT0146687", "brand_name": "特斯拉", "manufacturer": "特斯拉", "rlxs": "纯电动汽车", "scale": "SUV", "driving_condition": "593" } ``` 用于车辆识别、车型归类，是业务系统车辆档案的基础信息。 ### 2. 尺寸与质量信息 ``` { "full_weight": "1921", "full_weight_max": "2432", "len": "4797", "width": "1920", "height": "1624" } ``` 整车物理参数，用于载重校验、车辆档案归档。 ### 3. 电芯信息 ``` { "cell_type": "磷酸铁锂电池", "cell_supplier": "宁德时代", "cell_code": "CB280", "cell_shape": "方壳", "cell_size": "64*280*84", "cell_voltage": "3.2", "cell_capacity": "180", "cell_count": "108", "cell_mass": "3.22", "cell_gravimetric_energy_density": "180" } ``` 重点字段： - `cell_type`：电芯类型（三元锂/磷酸铁锂），直接影响残值预估、保险风险等级和维修方案，是二手车、金融、保险优先关注的字段。 - `cell_supplier`：电芯原厂供应商，定损用来核验配件是否原厂，汽配平台用来匹配电芯货源，识别私自更换非原厂电芯的情况。 ### 4. 电池包PACK信息 ``` { "batt_pack_supplier": "特斯拉", "batt_pack_capacity": "180", "batt_pack_voltage": "348", "batt_pack_quantity": "62.5", "batt_pack_mass": "483", "batt_pack_density": "120-140", "batt_pack_combon": "1P108S" } ``` 重点字段： - `batt_pack_quantity`：电池标称电量kWh，也就是常说的电池度数，二手车页面核心展示字段。 - `batt_pack_voltage`：电池包标称总电压，维修安全参考，用于电池配件匹配。 - `batt_pack_mass`：整套电池包重量，用于保险估损、吊装运输评估。 - `batt_pack_combon`：串并联组合方案，维修工程师检修、更换电池时参考。 ### 5. BMS管理系统信息 ``` { "bms_supplier": "特斯拉公司" } ``` BMS是电池管理主板。该字段标识主板生产厂商，维修场景匹配BMS配件；定损场景核对更换的主板是否为原厂件，防范副厂件替换。 ## 四、Python调用示例 接口支持GET/POST，使用平台分配的key鉴权，入参为key和17位VIN码。 ``` import requests url = ""#接口地址 params = { "key": "替换成你的key", "vin": "替换17位车架号" } res = requests.get(url, params=params) print(res.json()) ``` ## 五、接入注意事项 1. VIN必须是标准17位车架号，建议代码中统一转大写再请求，避免格式报错； 2. 数据来源为公告档案，老旧车型、改装车、未上公告的新能源车辆可能返回无数据； 3. 本接口只提供出厂配置查询，如需SOH健康度、电芯压差、故障记录，需要单独使用电池健康报告接口。
