能源统计

开发中

POST

/api/open/bems/data-view/v1/external/energy-statistics

最后修改时间：2024-12-10 10:47:00

责任人：未设置

可视化能源统计接口，具体的入参图形引擎可视化进行配置。如果只是获取今日能耗的话，可以大屏可视化页面进行抓取即可

请求参数

Query 参数

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Timezone

string

时区

必需

示例值:

Asia/Shanghai

Authorization

string

Token

必需

示例值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIzNzEzNDIyMTgzMjE5ODkiLCJmbGFnIjozLCJ1c2VyX25hbWUiOiJ0ZXN0Iiwic2NvcGUiOlsic2V2ZXIiXSwibmFtZSI6InRlc3QiLCJleHAiOjE2OTA3OTA3NzksImp0aSI6ImEwZDI1MzkxLWY4ZjQtNGZhOS1hMzcyLTQ2MjYyMmMyY2Q5MSIsInRlbmFudCI6InQzNzE2Nzc1ODk1OTQxODIiLCJjbGllbnRfaWQiOiJzeXMifQ.RX4XLEK-F_U2Zvr4iYY2cZFTv-vqFITQ-E6WthVaaC4

Body 参数application/json

listData

array [object {3}]

必需

name

string

可选

mapData

object

可选

conditionsData

array[string]

传 [] 即可

可选

pageIndex

integer

必需

pageSize

integer

必需

samplingInterval

integer

传0即可

必需

samplingIntervalUnit

string

传0即可

必需

startTime

integer

开始时间

必需

endTime

integer

结束时间

必需

示例

{
  "listData": [
    {
      "name": "能源管理\\电\\分项\\达实大厦",
      "mapData": {
        "projectId": {
          "key": "能源管理",
          "value": "1192410229407772672"
        },
        "energyTypeCode": {
          "key": "电",
          "value": "01"
        },
        "dimensionCode": {
          "key": "分项",
          "value": "fx#org20240105013849718"
        },
        "energyItem": {
          "key": "达实大厦",
          "value": "dastower@0"
        }
      },
      "conditionsData": []
    }
  ],
  "pageIndex": 1,
  "pageSize": 2000,
  "samplingInterval": 0,
  "samplingIntervalUnit": "0",
  "startTime": 1710950400000,
  "endTime": 1711036800000
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/bems/data-view/v1/external/energy-statistics?project=1192410229407772672&instance=' \
--header 'Timezone: Asia/Shanghai' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIzNzEzNDIyMTgzMjE5ODkiLCJmbGFnIjozLCJ1c2VyX25hbWUiOiJ0ZXN0Iiwic2NvcGUiOlsic2V2ZXIiXSwibmFtZSI6InRlc3QiLCJleHAiOjE2OTA3OTA3NzksImp0aSI6ImEwZDI1MzkxLWY4ZjQtNGZhOS1hMzcyLTQ2MjYyMmMyY2Q5MSIsInRlbmFudCI6InQzNzE2Nzc1ODk1OTQxODIiLCJjbGllbnRfaWQiOiJzeXMifQ.RX4XLEK-F_U2Zvr4iYY2cZFTv-vqFITQ-E6WthVaaC4' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "listData": [
        {
            "name": "能源管理\\电\\分项\\达实大厦",
            "mapData": {
                "projectId": {
                    "key": "能源管理",
                    "value": "1192410229407772672"
                },
                "energyTypeCode": {
                    "key": "电",
                    "value": "01"
                },
                "dimensionCode": {
                    "key": "分项",
                    "value": "fx#org20240105013849718"
                },
                "energyItem": {
                    "key": "达实大厦",
                    "value": "dastower@0"
                }
            },
            "conditionsData": []
        }
    ],
    "pageIndex": 1,
    "pageSize": 2000,
    "samplingInterval": 0,
    "samplingIntervalUnit": "0",
    "startTime": 1710950400000,
    "endTime": 1711036800000
}'

返回响应

🟢200成功

application/json

Body

header

array[string]

标题

必需

resultSet

array [array]

结果

必需

string

可选

totalPage

integer

总数

必需

isPaginationTrue

boolean

是否分页

必需

示例

{
  "header": [
    "能源类型",
    "能源维度",
    "能源分项",
    "数据源",
    "指标值"
  ],
  "resultSet": [
    [
      "电",
      "-",
      "达实大厦",
      "能源管理",
      "123787.0"
    ]
  ],
  "totalPage": 1,
  "isPaginationTrue": false
}

🟠400400响应结构

获取今日总能耗

获取尖峰平谷能耗数据