
## 一、应用场景

- 新能源二手车平台与车商：收车验车、车辆定价，出具配套电池检测报告
- 汽车金融、融资租赁：车辆抵押风控、残值评估、逾期车辆处置
- 第三方检测机构、维保门店：增加新能源三电专项检测项目
- 保险机构：延保承保、出险定损，区分电池自然老化和事故损伤
## 二、接口详解
新能源电池报告查询，输入车辆的VIN车架号，可以查询电池健康度检测、当前续航分析、电池使用习惯、电池充电状态等信息。
|项目|说明|
|:-:|:-:|
|接口名称|新能源电池健康报告查询API|
|请求协议|HTTPS|
|请求方式|GET|
|入参|key（接口密钥）、vin（17位车架号）|
|返回格式|JSON|

![屏幕截图 2026-09-23 112912.png](https://developer.qcloudimg.com/http-save/yehe-12701231/4c0886eda5a257f88f67c0c490e38ca4.png)

## 三、返回示例
```json
{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "vin": "LC0C6666666127672", // 车架号
    "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": "[\"减少快充比例。\"]" // 车辆充放电模块-建议
  }
}
```

### 返回数据可分为4部分

✅**车辆基础信息**
车架号、品牌、年份

✅**电池出厂静态参数**
电池厂商、标定容量、续航、电池类型

✅**电池健康衰减指标（核心）**
二手车评估核心，SOH + 衰退风险等级，可以判断电池值不值钱、有没有隐患；

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| battery_soh | string | 电池健康度 SOH，百分比；实际容量 ÷ 出厂标称容量，核心衰减指标 |
| battery_soh_level | string | SOH 等级：优秀、良好、中等、较差、差，用于直观评级 |
| volume_score_recession | string | 电池衰退水平值，量化衰减综合分数，不只看 SOH，结合异常、压差等 |
| volume_score_recession_level | string | 安全风险等级：低、较低、较高、高，提示电池潜在故障风险 |
| volume_score_recession_desc | string | 安全风险文字解读，说明风险来源（如衰减过快、压差异常等） |

✅**续航参考**
估算可用续航，把抽象的电池衰减，换算成易懂的实际能跑里程

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| refer_rate_mileage | string | 当前参考续航 (km)：结合 SOH 衰减估算的实际可用续航，不是表显续航 |
| refer_rate_mileage_desc | string | 当前参考续航文字分析，解释续航衰减程度 |

✅**充电循环使用数据（用车习惯数据）**
看车主平时是不是经常快充，解释电池衰减快的原因。

- 两台同样 SOH 的车：一台很少快充，一台长期快充，后续衰减速度不一样，残值和风险也要区别对待。金融、车商收车时，这个维度可以用来议价。

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| total_charge_count | string | 总充电次数，包含慢充、快充所有充电记录 |
| total_charge_soc | string | 充放电循环次数（完整循环：100% 电量消耗再充满，≠充电次数） |
| fast_ratio | string | 快充占比 (%)：快充次数 / 总充电次数的占比 |
| fast_ratio_desc | string | 快充占比结论：正常、偏高；高频快充会加速电池老化 |
| battery_habit_level | string | 电池使用习惯综合等级：优秀 / 良好 / 中等 / 较差，综合快充频率、充放电区间判定 |

✅**风险提示与建议**
充放电模块注意事项，风险警示文本；充放电维护建议，给到检测人员的优化方案。用于生成 PDF 检测报告、小程序展示的文字。

## 四、接入注意事项

1. **数据覆盖限制**：数据取决于车企 BMS 对外开放程度，部分品牌、年份的车型无法返回动态健康数据，接口会返回无数据，不计费。

2. **数据定位**：电池评估结果是基于 BMS 记录推算的参考值，不等同于线下机房专业检测，适合商业评估，不适合直接作为司法鉴定唯一依据。

3. **批量请求**：大批量核验时做好请求限流，高频并发容易触发接口风控。

新能源电池报告查询，输入车辆的VIN车架号，可以查询电池健康度检测、当前续航分析、电池使用习惯、电池充电状态等信息。

新能源电池健康报告查询 API 介绍及业务场景实践

本文介绍 探数API 的新能源电池健康报告查询API，通过VIN车架号获取动力电池专项评估报告，输出电池SOH健康度、衰减风险、预估续航、充电循环及快充占比等数据。可集成于二手车交易、金融风控、车辆检测、车队管理等系统。

大数据

开发工具

后端

新能源电池健康报告API通过VIN车架号实时查询电池SOH健康度、续航衰减、快充占比及安全风险等级等核心数据，覆盖比亚迪等主流品牌。适用于二手车定价、金融风控、保险定损及检测机构，支持电池静态参数与动态使用习惯双重评估，帮助用户精准识别电池隐患并辅助议价决策。

代码解释

JSON

2026上云采购 | AI焕新·智启新局

bigdata-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

新能源电池健康报告查询 API 介绍及业务场景实践-腾讯云开发者社区-腾讯云

新能源电池健康报告查询 API 介绍及业务场景实践

新能源电池健康报告查询 API 介绍及业务场景实践

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐