达实AIoT
文档中心
快速开始
  • 单点登录对接
  • 开放接口对接
  • 领域模型事件对接
  • 私有部署
  • 应用开发指南
  • DASDesign
IoT平台
应用平台
  • 低代码工具
  • 基础服务
  • 系统运维
  • 场景模型
应用
  • 物业管理
  • 数据中心
  • 智慧园区IPS
  • 园区服务
  • 物业管理
  • 场景模型
  • 会议
  • 门禁
  • 停车场
文档中心
快速开始
  • 单点登录对接
  • 开放接口对接
  • 领域模型事件对接
  • 私有部署
  • 应用开发指南
  • DASDesign
IoT平台
应用平台
  • 低代码工具
  • 基础服务
  • 系统运维
  • 场景模型
应用
  • 物业管理
  • 数据中心
  • 智慧园区IPS
  • 园区服务
  • 物业管理
  • 场景模型
  • 会议
  • 门禁
  • 停车场
期待您的声音
  1. 水热一体化子系统
  • 轻应用
  • 图形引擎
  • 业务编排
  • 数据中台
    • 接口统一认证方式
    • 销售子系统
      • API-body中的columns参数结构
      • 销售子系统API文档
    • 生产调度子系统
      • 生产调度子系统API文档
      • API-body中的columns参数结构
    • 新能源集控子系统
      • 新能源集控子系统API文档
      • API-body中的columns参数结构
    • 水热一体化子系统
      • 水热一体化子系统API
      • API-body中的columns参数结构
  1. 水热一体化子系统

API-body中的columns参数结构

本接口一共对应2张数据库表,请您传数据时找到对应表进行参数构建#

第一张表 荷-用户分类统计#

1. 表名(tableName):荷-用户分类统计#

适用场景:当 data_name 为以下值时使用该表:
居民用户数
大工业用户数
一般工商业用户数
纺织用户数
农业用户数

2. 请求体(Body)结构说明#

  "tableName": "荷-用户分类统计",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "居民用户数",
      1250,
      "户",
      "33333333/22222222",
      "1023/3204",
      2025,
      8,
      15,
      "2025-08-15 14:30:00"
    ],
    [
      "大工业用户数",             
      3680,                       
      "户",                       
      "33333333/22222222",
      "1023/3204",
      2024,
      8,
      15,
      "2025-08-15 14:30:00"
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 居民用户数
- 大工业用户数
- 一般工商业用户数
- 纺织用户数
- 农业用户数
"居民用户数"
valuedouble对应数据的数值(支持小数)12500.0、3680.5
unitstring数据的单位"户"
measure_point_namestring测点名"33333333/22222222"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 14:30:00"

4. 数据推送频率#

一年更新一次即可(1次/年)
📌
注意事项
recordTime_year、recordTime_month、recordTime_day指的是本次推送的这条数据被记录的时间,注意与updateTime区分
updateTime 需严格填写调用接口时的实时时间,不可使用历史时间或固定值,否则可能导致数据时效错误。
rows 数组中每个元素的顺序必须与 columns 定义的字段顺序完全一致(例如第一个元素对应 data_name,第二个对应 value 等)。

第二张表 荷-用户用电分析#

1. 表名(tableName):荷-用户用电分析#

适用场景:当 data_name 为以下值时使用该表:
大工业用电量
一般工商业用电量
居民用电量
纺织用电量
农业用电量

2. 请求体(Body)结构说明#

  "tableName": "荷-用户用电分析",
  "columns": [
    {"columnName": "corps", "dataType": "string"},
    {"columnName": "monthYear", "dataType": "string"},
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "第三师",     
      "月",            
      "大工业用电量",  
      56800.5,        
      "亿kWh",           
      "33333333/44444444",  
      "1023/3204",  
      2025,
      8,
      15,
      "2025-08-15 15:45:00"  
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
corpsstring以下值之一:
- 中新建
- 第三师
- 第七师
- 第八师
"第三师"、"中新建"
monthYearstring以下值之一:
- 月(表示月用电量)
- 年(表示年用电量)
"月"、"年"
data_namestring必须为以下值之一:
- 大工业用电量
- 一般工商业用电量
- 居民用电量
- 纺织用电量
- 农业用电量
"居民用电量"
valuedouble对应用电量的数值(支持小数)56800.5、125000.0
unitstring用电量的单位"亿kWh"
measure_point_namestring测点名"33333333/44444444"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 15:45:00"

4. 数据推送频率#

一天更新一次(1次/天)
📌
注意事项
recordTime_year、recordTime_month、recordTime_day指的是本次推送的这条数据被记录的时间,注意与updateTime区分
updateTime 需严格填写调用接口时的实时时间,不可使用历史时间或固定值,否则可能导致数据时效错误。
rows 数组中每个元素的顺序必须与 columns 定义的字段顺序完全一致(例如第一个元素对应 data_name,第二个对应 value 等)。

期待您的宝贵建议

微信扫描二维码,为我们的AIoT产品提出您的宝贵建议,用户体验是我们坚持不懈的追求。

微信扫描二维码
修改于 2025-08-21 05:48:18
上一页
水热一体化子系统API
Built with