行业痛点
新能源汽车上下游行业,比如二手车、汽车金融、维保、保险等,经常会遇到一个难题:
想知道一台车出厂原装电池是什么配置,电芯是哪家的、串并联结构、电池包总电量多少。
这些信息手动搜索也能查到,但查一辆车容易,批量查询就麻烦了,效率低不说,真实程度也没有保障,一些信息可能还查不到。
接口简介
新能源电池参数查询接口:传入17位VIN车架号,返回工信部备案的车辆出厂静态电池全套档案,包含车辆基础信息、电芯参数、PACK电池包参数、BMS供应商信息。
接口返回是是出厂公告静态信息,拿到的是新车下线登记的原始配置;不是实时SOH健康度。
适用业务场景
二手车平台:核验实车电池是否原厂,识别换包车、改装电池风险
汽车金融、融资租赁:车辆残值评估、风控尽调基础数据
汽修、三电维修门店:维修方案参考、配件匹配采购
车险定损:电池包定损、报价参考
三、接口请求说明
请求方式:POST
请求入参:vin 17位车架号
返回形式:JSON
完整返回样例
{
{
// 数据来源:探数API
"data": {
"vin": "LC0C74……687", // 车架号
"brand_name": "品牌名", // 品牌
"manufacturer": "企业名", // 车辆生产企业
"rlxs": "纯电动汽车", // 动力类型
"scale": "SUV", // 车辆类别
"driving_condition": "593", // 标称续航(km)
"full_weight": "1921", // 整备质量(kg)
"full_weight_max": "2432", // 总质量(kg)
"len": "4797", // 外形尺寸长(mm)
"width": "1920", // 外形尺寸宽(mm)
"height": "1624", // 外形尺寸高(mm)
"cell_type": "磷酸铁锂电池", // 电芯类型
"cell_supplier": "供应商名称", // 电芯供应商
"cell_code": "CB280", // 电芯型号
"cell_shape": "方壳", // 电芯形状
"cell_size": "64*280*84", // 电芯尺寸(mm)
"cell_voltage": "3.2", // 电芯电压(V)
"cell_capacity": "180", // 电芯容量(Ah)
"cell_count": "108", // 电芯数量(个)
"cell_mass": "3.22", // 电芯重量(kg)
"cell_gravimetric_energy_density": "180", // 电芯重量能量密度(Wh/kg)
"batt_pack_supplier": "供应商名称", // 电池包供应商
"batt_pack_capacity": "180", // 标称容量(Ah)
"batt_pack_voltage": "348", // 电池包标称电压(V)
"batt_pack_quantity": "62.5", // 电池包电量,标称能量(kWh)
"batt_pack_mass": "483", // 整车电池包重量(kg)
"batt_pack_density": "120-140", // 电池包能量密度范围(Wh/kg)
"batt_pack_combon": "1P108S", // 电池包组合方式
"bms_supplier": "企业名称" // BMS生产企业
}
}
返回字段分类解读
1. 车辆基础档案
| 字段 | 含义 |
|---|---|
| vin | 17 位车架号 |
| brand_name | 车辆品牌 |
| manufacturer | 生产厂家 |
| rlxs | 动力类型(纯电 / 插混) |
| scale | 车型类别,如 SUV、轿车 |
| driving_condition | 原厂标称续航,单位 km |
| full_weight | 整备质量 kg |
| full_weight_max | 最大总质量 kg |
| len / width / height | 长宽高,单位 mm |
2. 电芯层级(电池最小单元)
| 字段 | 含义 |
|---|---|
| cell_type | 电芯类型:磷酸铁锂 / 三元锂 |
| cell_supplier | 电芯供应商 |
| cell_code | 电芯型号 |
| cell_shape | 电芯形态:方壳、圆柱、软包 |
| cell_size | 电芯长宽厚尺寸 mm |
| cell_voltage | 单颗电芯标称电压 V |
| cell_capacity | 单颗电芯容量 Ah |
| cell_count | 整车一共多少颗电芯 |
| cell_mass | 单颗电芯重量 kg |
| cell_gravimetric_energy_density | 裸电芯能量密度 Wh/kg |
cell_type 电芯类型:区分三元锂、磷酸铁锂,影响残值、风险和维修策略,二手车、金融、保险都要优先看。
cell_supplier 电芯供应商:定损核对原厂件、汽配匹配货源,判断电池是否更换过非原厂电芯。
3. PACK电池包层级(业务最关心)
| 字段 | 含义 |
|---|---|
| batt_pack_supplier | 电池包集成厂商 |
| batt_pack_capacity | 电池包标称容量 Ah |
| batt_pack_voltage | 电池包标称总电压 V |
| batt_pack_quantity | 电池包总电量 kWh,就是我们常说的 62.5 度电 |
| batt_pack_mass | 整套电池包总重量 kg |
| batt_pack_density | 电池包能量密度区间 Wh/kg |
| batt_pack_combon | 串并联组合,示例:1P108S |
batt_pack_quantit 标称电量 (kWh):也就是电池度数,用户、二手车平台最直观的核心参数。
batt_pack_combon 电池包组合方式:维修人员看串并联结构,用于检修更换电池。
电芯指单纯的裸电芯;而 PACK 电池包额外包含外壳、BMS、冷却管路、线束、固定结构件等,整体重量更大,所以电池包的能量密度一定会低于裸电芯的能量密度。
✅ 重点解释 1P108S:
P = 并联,S = 串联
1P:每一组里面只有1颗电芯并联
108S:一共有108组串联起来
4. BMS电池管理系统
| 字段 | 含义 |
|---|---|
| bms_supplier | BMS 生产厂商 |
该字段主要用于BMS 配件采购、辅助核验整套三电总成是否为原厂配套。
六、极简Python接入示例
import requests
import json
url = "https://www.tanshuapi.com/market/detail-161"#接口地址
headers = {
"Content-Type": "application/json",
"Authorization": "你的token"
}
data = {
"vin": "LC0C……146687"
}
resp = requests.post(url=url, headers=headers, json=data)
res_json = resp.json()
if res_json["code"] == 1:
battery_info = res_json["data"]
print("品牌:", battery_info["brand_name"])
print("电芯供应商:", battery_info["cell_supplier"])
print("电池电量kWh:", battery_info["batt_pack_quantity"])
print("串并联方式:", battery_info["batt_pack_combon"])
else:
print("查询失败:", res_json["msg"])
小结
这个接口定位是原厂电池档案核验工具,核心价值就是用VIN快速拿到出厂电池标准配置,用来和实车配件做比对,降低新能源交易、维保、风控里面的信息差。JSON 结构化输出,很容易接入后台、H5 车况报告、导出 Excel。