AutoBigData 开放平台

切换主题

新能源电池报告-BatteryInfo ​

适用场景 ​

  • 新能源二手车估值：依据电池健康、容量、续航和里程判断车况与价格。
  • 金融与保险风控：辅助残值评估、车贷审核、保险承保和延保定价。
  • 售后维修与养护：结合检测结果和告警信息制定检修、更换及保养计划。
  • 车队运营管理：跟踪车辆电池状态、故障风险和使用表现，支持淘汰决策。

接口地址 ​

接口地址详见合作邮件通知

接口参数 ​

参数名字类型是否必须说明
access_token字符串必须访问令牌，生成令牌可使用 App.Auth.ApplyToken 接口（或联系商务提供）
vin字符串必须车架号，例如：LNBSCCAKXEF0200**

响应字段 ​

返回字段 ​

返回字段类型中文含义
retinteger旧版业务状态码；200 表示成功，4xx 表示客户端错误，5xx 表示服务端错误。
dataobject/null动力电池报告数据。
msgstring提示信息；失败时包含错误说明。

data 顶层字段 ​

字段类型中文含义
checkDatestring/null电池检测日期。
engineTypestring/null车辆动力类型；上游透传。
batteryInfoobject/null电池健康基本信息。
batteryStaticInfoarray电池静态基本信息列表；无数据时为空数组。
annualInspectionInfoarray动力电池年检项目列表；无数据时为空数组。
batteryEvaluationInfoarray同城同车型电池一致性对比列表；无数据时为空数组。
chargingHabitsobject/array近一年充电行为习惯信息。
batteryAlarmInfoobject/null近 90 天电池报警信息。
batteryMaintenanceMsgstring/null动力电池养护建议。
otherinfoarray车辆其他信息列表；无数据时为空数组。

batteryInfo 字段 ​

字段类型中文含义
batteryLevelstring/null电池综合评级；旧版示例为 S、A、B、C、D，实际仍以上游返回为准。
batteryModelstring/null电池型号。
batteryValuationnumber/null电池市场估值，单位元。
fullCapacityAssessmentnumber/null当前电池容量，单位 Ah。
fullEndurancenumber/string/null当前满电续航，单位 km。
batteryHealthValnumber/null电池健康得分。
batteryCapacityScorenumber/null容量得分。
temperatureAccordScorenumber/null温度一致性得分。
voltageAccordScorenumber/null电压一致性得分。
irAccordScorenumber/null内阻一致性得分。
isolationScorenumber/null自放电/绝缘指标得分。

列表和集合项目字段 ​

路径类型中文含义
batteryStaticInfo[].staticKey / staticName / staticValuestring静态字段编码、名称和值。
annualInspectionInfo[].annualInspectionNamestring年检项目名称。
annualInspectionInfo[].ownValuenumber本车检测值。
annualInspectionInfo[].annualInspectionValuestring年检标准或阈值。
annualInspectionInfo[].annualInspectionResultstring年检评估结果；常见“合格”，非封闭枚举。
batteryEvaluationInfo[].evaluationNamestring对比评估项名称。
batteryEvaluationInfo[].ownData / otherDatanumber本车/同城同车型对应数据。
batteryEvaluationInfo[].evaluationResultstring对比结果；常见“优秀”“正常”“较差”，非封闭枚举。
chargingHabits[].avgStartSoc / avgEndSocnumber平均充电起始/终止 SOC，单位百分比。
chargingHabits[].depthOfChargenumber充电深度，单位百分比。
chargingHabits[].fastChargingYearRatnumber近一年快充占比，单位百分比。
batteryAlarmInfo.batteryLevel1Alarm/2Alarm/3Alarmstring一级、二级、三级故障报警水平；常见“优秀”“一般”“差”，非封闭枚举。
otherinfo[].infoKey / infoName / infoValuestring其他信息编码、名称和值。

电池静态基本信息列表 ​

字段编码字段名称
enterpriseName电池生产企业
batteryType电池类型
batteryWarranty电池质保
powerChange是否换电
cellNumber电芯数量
singleCellShape电芯单体外形
singleCellVoltage电芯单体电压(V)
batteryCapacityNominal标称容量(Ah)
batteryEnergyNominal标称能量(kWh)
batteryVoltageNominal标称电压(V)
enduranceNominal标称续航(km)
fuelConsumption百公里耗电(kWh)
energyDensity能量密度(kWh/kg)
batteryWeight电池总质量(kg)
batteryCombinationMode电池组合方式

示例 ​

成功返回示例数据 ​

json

{  
    "batteryAlarmInfo": {  
        "batteryLevel2Alarm": "优秀",  
        "batteryLevel1Alarm": "优秀",  
        "batteryLevel3Alarm": "优秀"  
    },  
    "otherInfo": [  
        {  
            "infoName": "25-35度参考续航(夏季)",  
            "infoValue": "171",  
            "infoKey": "summerEndurance_01"  
        },  
        {  
            "infoName": "35-45度参考续航(夏季)",  
            "infoValue": "153",  
            "infoKey": "summerEndurance_02"  
        },  
        {  
            "infoName": "0-10度参考续航(春秋季)",  
            "infoValue": "153",  
            "infoKey": "springAutumnEndurance_01"  
        },  
        {  
            "infoName": "10-25度参考续航(春秋季)",  
            "infoValue": "166",  
            "infoKey": "springAutumnEndurance_02"  
        },  
        {  
            "infoName": "-10-0度参考续航(冬季)",  
            "infoValue": "117",  
            "infoKey": "winterEndurance_01"  
        },  
        {  
            "infoName": "<-10度参考续航(冬季)",  
            "infoValue": "90",  
            "infoKey": "winterEndurance_02"  
        },  
        {  
            "infoName": "循环次数",  
            "infoValue": "",  
            "infoKey": "cyclesNum"  
        },  
        {  
            "infoName": "总充电次数",  
            "infoValue": "",  
            "infoKey": "totalChargingNum"  
        },  
        {  
            "infoName": "表显里程",  
            "infoValue": "\/",  
            "infoKey": "totalMileage"  
        }  
    ],  
    "batteryEvaluationInfo": [  
        {  
            "ownData": 2,  
            "evaluationName": "历史单体平均温差（℃）",  
            "otherData": 4,  
            "evaluationResult": "优秀"  
        },  
        {  
            "ownData": 12,  
            "evaluationName": "历史单体平均压差（mV）",  
            "otherData": 28,  
            "evaluationResult": "优秀"  
        },  
        {  
            "ownData": 2,  
            "evaluationName": "历史单体最大温差（℃）",  
            "otherData": 4.8,  
            "evaluationResult": "优秀"  
        },  
        {  
            "ownData": 29,  
            "evaluationName": "历史单体最大压差（mV）",  
            "otherData": 45,  
            "evaluationResult": "优秀"  
        }  
    ],  
    "engineType": "插电式",  
    "annualInspectionInfo": [  
        {  
            "annualInspectionName": "动力蓄电池最高温度（℃）",  
            "annualInspectionValue": "≤60.0",  
            "annualInspectionResult": "合格",  
            "ownValue": 35  
        },  
        {  
            "annualInspectionName": "单体蓄电池最高电压（V）",  
            "annualInspectionValue": "≤4.5",  
            "annualInspectionResult": "合格",  
            "ownValue": 4.32  
        },  
        {  
            "annualInspectionName": "单体蓄电池电压极差（V）",  
            "annualInspectionValue": "≤0.3",  
            "annualInspectionResult": "合格",  
            "ownValue": 0.24  
        },  
        {  
            "annualInspectionName": "单体蓄电池最低电压（V）",  
            "annualInspectionValue": "≥1.8",  
            "annualInspectionResult": "合格",  
            "ownValue": 4.08  
        }  
    ],  
    "chargingHabits": {  
        "depthOfCharge": 43,  
        "avgStartSoc": 38,  
        "fastChargingYearRate": 13,  
        "avgEndSoc": 81  
    },  
    "checkDate": "2026-10-16",  
    "batteryMaintenanceMsg": "电池工况良好，请继续保持。",  
    "batteryInfo": {  
        "fullEndurance": "181",  
        "updateDate": null,  
        "batteryCapacityScore": 96,  
        "isolationScore": 95,  
        "batteryValuation": 22656,  
        "batteryHealthVal": 96,  
        "batteryModel": "",  
        "voltageAccordScore": 99,  
        "fullCapacityAssessment": 109.4,  
        "batteryLevel": "S",  
        "temperatureAccordScore": 99,  
        "irAccordScore": 97  
    },  
    "batteryStaticInfo": [  
        {  
            "staticName": "电池生产企业",  
            "staticValue": "蜂巢能源科技股份有限公司\/蜂巢能源科技(遂宁)有限公司",  
            "staticKey": "packManufacturer"  
        },  
        {  
            "staticName": "电池类型",  
            "staticValue": "三元材料电池",  
            "staticKey": "batteryType"  
        },  
        {  
            "staticName": "电池质保",  
            "staticValue": "8年或16万公里",  
            "staticKey": "batteryWarranty"  
        },  
        {  
            "staticName": "是否换电",  
            "staticValue": "否",  
            "staticKey": "powerChange"  
        },  
        {  
            "staticName": "电芯数量",  
            "staticValue": "140",  
            "staticKey": "cellNumber"  
        },  
        {  
            "staticName": "电芯单体外形",  
            "staticValue": "方形",  
            "staticKey": "singleCellShape"  
        },  
        {  
            "staticName": "电芯单体电压(V)",  
            "staticValue": "3.7",  
            "staticKey": "singleCellVoltage"  
        },  
        {  
            "staticName": "标称容量(Ah)",  
            "staticValue": "114",  
            "staticKey": "batteryCapacityNominal"  
        },  
        {  
            "staticName": "标称能量(kWh)",  
            "staticValue": "59",  
            "staticKey": "batteryEnergyNominal"  
        },  
        {  
            "staticName": "标称电压(V)",  
            "staticValue": "518",  
            "staticKey": "batteryVoltageNominal"  
        },  
        {  
            "staticName": "标称续航(km)",  
            "staticValue": "201",  
            "staticKey": "enduranceNominal"  
        },  
        {  
            "staticName": "百公里耗电(kWh)",  
            "staticValue": "7.75",  
            "staticKey": "fuelConsumption"  
        },  
        {  
            "staticName": "能量密度(Wh\/kg)",  
            "staticValue": "170.66",  
            "staticKey": "energyDensity"  
        },  
        {  
            "staticName": "电池总质量(kg)",  
            "staticValue": "346",  
            "staticKey": "batteryWeight"  
        },  
        {  
            "staticName": "电池组合方式",  
            "staticValue": "1P140S",  
            "staticKey": "batteryCombinationMode"  
        },  
        {  
            "staticName": "电芯生产企业",  
            "staticValue": "蜂巢能源科技股份有限公司\/蜂巢能源科技(遂宁)有限公司",  
            "staticKey": "cellEnterpriseName"  
        }  
    ]  
}

失败返回示例数据，参数错误 ​

json
{
    "ret": 400,
    "data": {},
    "msg": "vin格式不规范"
}

错误码 ​

查无数据 ​

json
{
    "ret": 414,
    "data": {},
    "msg": "查无数据"
}

错误列表 ​

错误状态码错误描述信息
400ret=400，客户端参数错误或非法请求
404ret=404，表示接口服务不存在
406ret=406，access_token令牌校验不通过
407ret=407，app_key权限不足，或未知应用
408ret=408，当前用户禁止使用，或用户未登录
414ret=414，查无数据
500表示服务端内部错误

Copyright © 2026 北京奥图德塔咨询有限公司 All rights reserved. 网站备案号 京ICP备16010040号-1