新能源电池报告-battery-assessments

适用场景

• 新能源二手车估值与交易核验：依据电池健康度、续航、容量、里程和电池估算价值判断车况与价格。
• 金融与保险风控：辅助车贷、融资租赁、保险承保及残值评估，识别电池衰减和异常风险。
• 售后维修与电池养护：结合检查项目、告警等级和维护建议，制定保养、检修及电池更换方案。
• 车队运营管理：跟踪车辆电池状态、充电习惯、里程事件和异常记录，优化车辆调度与淘汰。
• 厂家及经销商产品服务：分析不同车型、电池型号和使用场景的性能表现，支持质量改进和延保服务设计。

接口地址

POST /api/v1/veh-battery-assessments

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

请求参数

请求

请求头：Authorization: Bearer <ACCESS_TOKEN>、Content-Type: application/json。

{
  "vin":"1HGBH41JXMN00****",
  "plate":"",
  "modelCode":"FV6465BABEV",
  "usageType":"非营运"
}

vin 必填且为 17 位 VIN；plate 可选；modelCode 长度 1 至 128；usageType 长度 1 至 64 且不能为空。请求体不得加入其他字段。

响应字段

通用响应字段

字段	类型	中文含义
code	string	业务状态码：0000 成功、0001 没有可用评估数据、4001 参数格式错误、5001 服务处理失败。认证层拒绝时不使用该业务信封。
message	string	业务处理结果说明；成功、无数据或失败时由服务返回相应文字。
data	object/array/null	业务结果。成功时为对象或数组；查无数据或业务失败时通常为 null。
request_id	string	请求链路标识，用于问题排查；不要用它替代密钥或 Token。

data 顶层字段

字段	类型	中文含义
vin	string/null	车辆 VIN。
isDataAvailable	boolean	是否存在可用电池评估数据；成功报告中为 true。
modelCode	string/null	请求或供应商返回的车型编码。
inspectionDate	string/null	电池评估/检测日期。
powertrainType	string/null	动力类型；上游透传，非封闭枚举。
maintenanceAdvice	string/null	动力电池养护建议。
salesModelName	string/null	销售车型名称。
vehicleModel	string/null	车辆型号。
manufactureYear	string/null	生产年份或上游生产时间字段。
firstRegistrationDate	string/null	初次登记日期。
totalMileageKm	string/null	总里程，单位为公里；数值以字符串保留精度。
totalMileageRecordedAt	string/null	总里程记录时间。
mileageAssessmentDesc	string/null	里程评估说明。
fuelCellRatedPower	string/null	燃料电池额定功率。
driveMotorRatedPower	string/null	驱动电机额定功率。
batteryHealth	object/null	电池健康度指标集合。
batterySpecs	array	电池规格键值列表；无数据时为空数组。
additionalMetrics	array	其他评估指标列表；无数据时为空数组。
alarmLevels	object	近 90 天电池告警等级集合；无数据时为空对象。
chargingHabits	object	充电习惯指标集合；无数据时为空对象。
inspectionItems	array	动力电池检查项目列表。
peerComparisonItems	array	同类车辆对比项目列表。
mileageEvents	array	历史里程事件列表。

batteryHealth 字段

字段	类型	中文含义
fullChargeRangeKm	string/null	满电续航里程，单位为公里。
capacityScore	string/null	容量指标评分。
batteryModel	string/null	电池型号。
temperatureConsistencyScore	string/null	温度一致性评分。
selfDischargeScore	string/null	自放电指标评分。
estimatedValueCny	string/null	电池估算价值，单位为人民币。
healthScore	string/null	电池健康度评分。
voltageConsistencyScore	string/null	电压一致性评分。
currentCapacityAh	string/null	当前容量，单位 Ah。
overallRating	string/null	电池综合评级；上游透传，旧版示例有 S/A/B/C/D，但不作为现代接口封闭枚举。
internalResistanceConsistencyScore	string/null	内阻一致性评分。

列表和集合项目字段

路径	类型	中文含义
batterySpecs[].code / additionalMetrics[].code	string/null	指标编码。
batterySpecs[].name / additionalMetrics[].name	string	指标名称。
batterySpecs[].value / additionalMetrics[].value	string/null	指标值。
inspectionItems[].name	string	检查项目名称。
inspectionItems[].vehValue	string/null	车辆实际值。
inspectionItems[].threshold	string/null	判断阈值。
inspectionItems[].result	string/null	检查结果；上游透传，非封闭枚举。
peerComparisonItems[].name	string	对比指标名称。
peerComparisonItems[].vehValue	string/null	本车指标值。
peerComparisonItems[].peerValue	string/null	同类车辆指标值。
peerComparisonItems[].result	string/null	对比结果；上游透传，非封闭枚举。
alarmLevels.levelOne / levelTwo / levelThree	string/null	一级、二级、三级告警水平；上游透传，非封闭枚举。
chargingHabits.annualFastChargingRatePercent	string/null	近一年快充占比，单位百分比。
chargingHabits.averageChargeEndSocPercent	string/null	平均充电终止 SOC，单位百分比。
chargingHabits.chargeDepthPercent	string/null	充电深度，单位百分比。
chargingHabits.averageChargeStartSocPercent	string/null	平均充电起始 SOC，单位百分比。
mileageEvents[].recordedMileage_10K_Km	string/null	记录里程，单位为万公里。
mileageEvents[].recordedAt	string/null	里程记录日期或时间。
mileageEvents[].isAbnormal	boolean/null	该条里程记录是否异常。
mileageEvents[].mileageDelta_10k_Km	string/null	相邻记录里程差，单位为万公里。

数值字段除布尔字段外均以字符串返回；未提供的可选字段为 null，列表无数据为空数组，集合无数据为空对象。

示例

免费测试案例和 curl

使用当前 Swagger 默认入参：vin=1HGBH41JXMN00****、plate 为空、modelCode=FV6465BABEV、usageType=非营运。

curl -X POST \
  "接口地址详见合作邮件通知" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"vin":"1HGBH41JXMN00****","plate":"","modelCode":"FV6465BABEV","usageType":"非营运"}'

成功响应

以下为按默认测试入参整理的字段结构示例；健康度、日期和评级仅用于说明返回格式，实际结果以接口返回为准。

{
  "code":"0000",
  "message":"成功",
  "data":{
    "vin":"1HGBH41JXMN00****",
    "isDataAvailable":true,
    "modelCode":"FV6465BABEV",
    "inspectionDate":"2026-06-01",
    "powertrainType":"纯电动",
    "maintenanceAdvice":"建议按周期检查电池状态",
    "salesModelName":"示例车型",
    "vehicleModel":"示例车型",
    "manufactureYear":"2022",
    "firstRegistrationDate":"2022-06-01",
    "totalMileageKm":"1.0000",
    "totalMileageRecordedAt":"2026-06-01",
    "mileageAssessmentDesc":"里程记录正常",
    "fuelCellRatedPower":null,
    "driveMotorRatedPower":"100",
    "batteryHealth":{"fullChargeRangeKm":"420","capacityScore":"95","batteryModel":"示例电池","temperatureConsistencyScore":"98","selfDischargeScore":"97","estimatedValueCny":"80000","healthScore":"95","voltageConsistencyScore":"96","currentCapacityAh":"120","overallRating":"A","internalResistanceConsistencyScore":"97"},
    "batterySpecs":[{"code":"capacity","name":"电池容量","value":"60"}],
    "additionalMetrics":[{"code":"energy","name":"能耗","value":"14.5"}],
    "alarmLevels":{"levelOne":null,"levelTwo":null,"levelThree":null},
    "chargingHabits":{"fastChargeRatio":"0.30","slowChargeRatio":"0.70"},
    "inspectionItems":[{"name":"电池健康度","vehValue":"95","threshold":"80","result":"正常"}],
    "peerComparisonItems":[{"name":"健康度","vehValue":"95","peerValue":"90","result":"较好"}],
    "mileageEvents":[{"recordedMileage_10K_Km":"1.0000","recordedAt":"2026-06-01","isAbnormal":false,"mileageDelta_10k_Km":"0.0000"}]
  },
  "request_id":"request-id"
}

data 还可能包含车辆信息、维护建议、里程信息和评估明细；未提供的数据返回 null 或空数组。上游无数据时按 0001 和 data=null 处理。

错误码

业务码与注意事项

0000 成功，0001 没有可用评估数据，4001 参数格式不正确，5001 服务处理失败。认证层错误按 401、403、429、503 处理。

服务处理失败（HTTP 200）

{"code":"5001","message":"供应商接口调用失败","data":null,"request_id":"request-id"}

认证层错误为 HTTP 401、403、429、503，不使用上述业务码。

没有可用评估数据（HTTP 200）

{"code":"0001","message":"查无数据","data":null,"request_id":"request-id"}