kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
develop
datai/docs/archive/api-docs/integration/DataiIntegrationMetadataChangeController/0006-trend-statistics.md

5.9 KiB
Raw Permalink Blame History

接口文档：获取趋势变更统计信息

接口信息

  • 接口名称: 获取趋势变更统计信息
  • 接口路径: /integration/change/statistics/trend
  • 请求方法: GET
  • 模块归属: integration
  • 版本号: v1.0
  • 创建日期: 2026-01-09
  • 最后更新: 2026-01-09

功能描述

获取元数据变更的趋势统计信息，支持按天、周、月、季度等时间维度查看变更趋势，可根据变更类型、操作类型、对象API名称、同步状态、是否自定义和时间范围等条件进行筛选。

请求参数

查询参数

参数名 类型 必填 描述 示例 默认值
timeUnit String 是 时间维度，支持：day, week, month, quarter day 无
changeType String 否 变更类型 OBJECT 无
operationType String 否 操作类型 CREATE 无
objectApi String 否 对象API名称 Account 无
syncStatus Boolean 否 同步状态 false 无
isCustom Boolean 否 是否自定义 true 无
startTime String 否 开始时间，格式：yyyy-MM-dd HH:mm:ss 或 yyyy-MM-dd 2026-01-01 00:00:00 无
endTime String 否 结束时间，格式：yyyy-MM-dd HH:mm:ss 或 yyyy-MM-dd 2026-01-07 23:59:59 无

响应数据

成功响应

HTTP 状态码: 200 OK

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "totalCount": 100,
    "timeUnit": "day",
    "trends": [
      {
        "time": "2026-01-01",
        "count": 15
      },
      {
        "time": "2026-01-02",
        "count": 20
      },
      {
        "time": "2026-01-03",
        "count": 10
      },
      {
        "time": "2026-01-04",
        "count": 25
      },
      {
        "time": "2026-01-05",
        "count": 30
      }
    ]
  }
}
字段名 类型 描述 示例
totalCount Integer 总变更数 100
timeUnit String 时间维度 day
trends Array 趋势数据 按时间维度统计的变更数据
trends[].time String 时间点 2026-01-01
trends[].count Integer 该时间点的变更数 15

失败响应

HTTP 状态码: 400 Bad Request

{
  "code": 400,
  "message": "时间维度不正确，支持的维度：day, week, month, quarter",
  "data": null
}
错误码 错误信息 描述
400 时间维度不正确 时间维度参数错误
400 开始时间格式不正确 开始时间格式错误
400 结束时间格式不正确 结束时间格式错误
403 无权限执行此操作 当用户没有integration:change:statistics权限时
500 统计失败 服务器内部错误导致统计失败

接口示例

请求示例

curl -X GET "http://localhost:8080/integration/change/statistics/trend?timeUnit=day&startTime=2026-01-01&endTime=2026-01-05" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [token]"

响应示例

成功:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "totalCount": 100,
    "timeUnit": "day",
    "trends": [
      {
        "time": "2026-01-01",
        "count": 15
      },
      {
        "time": "2026-01-02",
        "count": 20
      },
      {
        "time": "2026-01-03",
        "count": 10
      },
      {
        "time": "2026-01-04",
        "count": 25
      },
      {
        "time": "2026-01-05",
        "count": 30
      }
    ]
  }
}

失败:

{
  "code": 400,
  "message": "时间维度不正确，支持的维度：day, week, month, quarter",
  "data": null
}

错误处理

  • 400 Bad Request: 时间维度错误、时间格式错误或其他参数错误
  • 403 Forbidden: 用户无权限执行此操作
  • 500 Internal Server Error: 服务器内部错误导致统计失败

注意事项

  • 统计操作可能耗时较长，取决于数据量大小
  • timeUnit参数为必填，支持的维度：day, week, month, quarter
  • 支持多种筛选条件与时间维度组合使用
  • 时间参数支持两种格式：yyyy-MM-dd HH:mm:ss 或 yyyy-MM-dd
  • 当未提供时间范围时，会根据时间维度自动选择合适的时间范围

相关接口

实现细节

  • 接口通过构建参数Map调用dataiIntegrationMetadataChangeService.getChangeStatisticsByTrend()方法获取统计信息
  • 服务层会根据传入的时间维度和筛选条件进行趋势统计
  • 支持时间维度验证和时间格式验证
  • 统计结果包括总变更数和按时间维度统计的趋势数据

测试信息

测试环境

  • 环境: 开发环境
  • 版本: v1.0

测试用例

测试场景 输入参数 预期结果 实际结果 状态
按天维度查看趋势 timeUnit=day&startTime=2026-01-01&endTime=2026-01-05 操作成功，返回按天统计的趋势数据 操作成功，返回按天统计的趋势数据 通过
按周维度查看趋势 timeUnit=week&startTime=2025-12-28&endTime=2026-01-10 操作成功，返回按周统计的趋势数据 操作成功，返回按周统计的趋势数据 通过
按月维度查看趋势 timeUnit=month&startTime=2025-12-01&endTime=2026-02-28 操作成功，返回按月统计的趋势数据 操作成功，返回按月统计的趋势数据 通过
无效时间维度 timeUnit=invalid 操作失败，返回时间维度错误信息 操作失败，返回时间维度错误信息 通过
无权限获取统计 任意参数 操作失败，返回403错误 操作失败，返回403错误 通过