区别于燃油车，新能源车辆的核心价值载体是动力电池。电池SOH健康度、续航衰减情况、等效循环次数、充电行为习惯，是车辆残值评估、风险识别中最重要的指标，也是二手车、金融、维保各方重点关注的数据。
接口概述
新能源电池报告查询API，基于车架号VIN进行查询，返回动力电池健康检测结果、参考续航评估、充电行为分析、衰退风险等级以及保养建议，可直接集成到业务系统，快速生成标准化车况报告。
能力亮点：突破传统VIN接口只能查询出厂参数的局限，输出带健康评级、风险诊断、保养建议的综合评估结果，适合新能源车车况评估场景接入。
返回结果示例
{
//数据来源：探数API https://www.tanshuapi.com/market/detail-162
{
"data": {
"vin": "LC0……27672", // 车架号
"brand_name": "品牌名字", // 品牌
"battery_manufacturer": "厂商名字", // 电池厂商
"rate_capacity": "135", // 标称容量(Ah)
"rate_mileage": "605", // 标称续航(km)
"nominal_energy": "76.9", // 标称能量(kWh)
"battery_type": "磷酸铁锂电池", // 电池类型
"manufacturer_date": "2021", // 车辆生产年份
"refer_rate_mileage": "483", // 当前参考续航(km)
"refer_rate_mileage_desc": "↓20.2%", // 当前参考续航-分析
"battery_soh": "88.01", // 电池健康度(SOH)
"battery_soh_level": "中等", // 电池健康度(SOH)-等级，优秀、良好、中等、较差、差
"volume_score_recession": "1", // 电池衰退水平值
"volume_score_recession_level": "较低", // 安全风险水平-等级，低，较低，较高，高
"volume_score_recession_desc": "[\"本车动力电池SOH（电池健康度）为<strong>88.01</strong>%，车辆电池衰退水平值超过同类车型平均的<strong>1.0</strong>倍，动力系统发生严重故障的概率较低。\"]", // 安全风险水平-分析
"total_charge_count": "581", // 总充电次数
"total_charge_soc": "409.9", // 循环次数
"fast_ratio": "36", // 快充占比(%)
"fast_ratio_desc": "偏高", // 快充占比-分析，正常、偏高
"battery_habit_level": "良好", // 电池使用习惯等级，优秀、良好、中等、较差
"discharging_attention": "[\"快充占比偏高，电池容易衰退。\"]", // 车辆充放电模块-注意
"discharging_suggest": "[\"减少快充比例。\"]" // 车辆充放电模块-建议
}
}
}
}
返回字段分类解读与开发注意事项
返回数据按业务语义划分为5个模块，便于前端页面分模块渲染、后端做业务逻辑处理。
1. 车辆与电池出厂基础信息
包含车架号、品牌、车辆生产年份、电池厂商、标称容量、原厂标称续航、标称电量、电池类型。
重点字段：
vin、brand_name、battery_type、nominal_energy
开发提示：该组属于出厂静态数据，不会随用车状态变化。
2. 电池健康与续航衰减指标（核心估值模块）
| 字段 | 说明 |
|---|---|
| refer_rate_mileage | 当前参考续航（估算值，单位km） |
| refer_rate_mileage_desc | 续航衰减比例描述 |
| battery_soh | 电池健康度SOH（%） |
| battery_soh_level | SOH等级：优秀 / 良好 / 中等 / 较差 / 差 |
重点字段：
battery_soh、battery_soh_level、refer_rate_mileage
开发提示：SOH是二手车定价、残值评估的核心指标；refer_rate_mileage为算法估算参考值，并非车机实时表显续航，页面展示建议标注【参考值】，规避业务纠纷。
3. 电池衰退风险评估模块
| 字段 | 说明 |
|---|---|
| volume_score_recession | 电池衰退水平分值 |
| volume_score_recession_level | 衰退风险等级：低、较低、较高、高 |
| volume_score_recession_desc | 风险解读文本数组，可直接渲染报告 |
重点字段：
volume_score_recession_level、volume_score_recession_desc
开发提示：用于安全风险提示、金融风控、保险承保初审。
返回文本内自带HTML标签，富文本页面直接渲染，纯文本页面需要做HTML转义，防止页面错乱。
4. 充电循环与用车习惯分析模块
| 字段 | 说明 |
|---|---|
| total_charge_count | 累计充电总次数 |
| total_charge_soc | 等效循环次数 |
| fast_ratio | 快充占比（%） |
| fast_ratio_desc | 快充占比评价：正常 / 偏高 |
| battery_habit_level | 综合充放电习惯等级：优秀 / 良好 / 中等 / 较差 |
重点字段：
total_charge_soc、fast_ratio、battery_habit_level
开发提示：快充占比是解释电池衰减速度的关键维度，快充占比偏高的车辆可针对性增加提醒；用车习惯评级适合面向车主做用车科普引导。
5. 风险提醒与保养建议文案（面向C端展示）
| 字段 | 说明 |
|---|---|
| discharging_attention | 充放电风险提醒数组 |
| discharging_suggest | 电池保养优化建议数组 |
开发提示：两个字段都是数组类型，前端需要循环遍历渲染，不能直接当做字符串展示；文案为标准化业务建议，适合放在报告底部，仅作保养科普参考。
典型业务应用场景
- 新能源二手车
用于收车阶段车况核验、车源详情页展示电池体检报告，辅助定价，出具线上检测报告。 - 检测机构、维保门店
检测结果存入维保工单，持续跟踪同一台车SOH衰减趋势，向车主输出保养建议。 - 租赁、抵押
放款前评估电池残值，预判资产贬值速度；租期结束车辆回收时作为估价依据。 - 保险
承保前结合SOH、衰退等级评估承保风险，支撑保费差异化定价；理赔环节辅助区分电池损坏是事故损伤还是自然老化衰减，辅助风险核验。
