简介
随着新能源汽车存量持续增长，二手车交易、车险承保定损、新能源汽修配件匹配等业务，都需要获取车辆原厂电池公告参数。
⚠️ 重要边界说明：本接口返回出厂公告静态参数，不含SOH健康度、电芯压差、充放电循环次数等BMS动态检测数据，不用于电池衰减评估。
一、业务适用场景
- 二手车交易：获取原厂三电配置，用于车辆信息展示、辅助残值评估；
- 车险业务：承保环节采集电池规格用于风险标签与保费参考；事故维修后比对原厂参数，辅助定损；
- 汽修汽配：依据VIN快速匹配电池包、电芯、BMS原厂型号，支撑配件选型与工单信息填充；
- 其他场景：新能源车型档案库搭建、金融风控资产建档、基础车型信息核验。
二、接口介绍
传入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），也就是常说的电池度数，是C端用户、二手车页面最核心的展示参数。batt_pack_voltage：电池包标称总电压，维修检修安全参考，同时用于电池配件匹配。batt_pack_mass：整套电池包重量，保险事故估损、吊装运输评估常用。batt_pack_combon：电池包串并联组合方式，维修工程师排查、更换电池时作为结构参考。
5. BMS管理系统信息
{
"bms_supplier": "特斯拉公司"
}
BMS即电池管理主板。该字段标识主板生产厂商；维修时用来匹配适配的BMS配件，出险定损时可核对更换的BMS是否为原车配套原厂件，防范副厂件替换。
四、Python调用示例
import requests
url = ""#接口地址
params = {
"key": "替换成你的key",
"vin": "替换17位车架号"
}
res = requests.get(url, params=params)
print(res.json())
五、常见问题
Q1：接口适合哪些业务场景使用？
A：适合二手车平台三电配置展示、车险承保定价与事故定损比对、汽修汽配匹配电池/BMS原厂配件、金融风控资产建档、搭建新能源车型档案库。
Q2：返回数据里电芯和电池包参数怎么区分？
A：字段前缀cell_代表单颗裸电芯参数；前缀battpack代表整套电池PACK包，包含电芯、壳体、线束、热管理总成。
Q3：什么情况会查不到车辆三电数据？
A：老旧车型、改装新能源车、未录入公告的车辆没有档案，会返回无数据。
