feat: 完善每日氢耗明细导出与质量标记

vehicle-data-platform/apps/api/internal/openplatform/assets/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: 车辆数据开放平台 API
-  version: 1.6.0
+  version: 1.7.0
   license:
     name: Proprietary
   description: |
@@ -20,7 +20,7 @@ paths:
     post:
       tags: [合作方数据接口]
       summary: 查询车辆单日用氢量
-      description: plateNumbers 省略或传空数组时，返回该应用在查询自然日有效授权的全部车辆。
+      description: plateNumbers 省略或传空数组时，返回该应用在查询自然日有效授权的全部车辆。SUSPECT 计算结果保留用氢量并以 DATA_ANOMALY 输出，同时返回质量原因。
       operationId: queryDailyHydrogenConsumption
       security:
         - AppKeyAuth: []
@@ -619,7 +619,7 @@ components:
           type: number
           format: double
           nullable: true
-          description: 单日用氢量，kg；无数据时为 null
+          description: 单日用氢量，kg；OK 和 SUSPECT 计算结果均返回数值，无数据时为 null
         calculationPhase:
           type: string
           enum: [PRELIMINARY, FINAL]
@@ -627,6 +627,13 @@ components:
         algorithmVersion:
           type: string
           description: 氢耗计算算法版本
+        qualityStatus:
+          type: string
+          enum: [OK, SUSPECT, NO_DATA]
+          description: 氢耗计算质量状态
+        qualityReason:
+          type: string
+          description: 质量判定原因；SUSPECT 或 NO_DATA 时供调用方解释和审计
         status:
           $ref: '#/components/schemas/DataStatus'
     MileageResult: