获取能耗趋势 - 达实AIoT

请求参数

Query 参数

project

string

可选

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

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

可选

默认值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU

Body 参数application/json

energyObjs

array [object {5}]

必需

objectId

string

对象id

必需

gradationId

string

必需

层级id，如果为对象层级id为0

name

string

当前对象或层级名称

必需

pathName

string

路径名称

必需

dimensionId

string

必需

维度id，如果为对象维度id为0

offset

integer

时区，传8

必需

startTime

integer

开始时间

必需

endTime

integer

结束时间

必需

dataGranularity

string

必需

数据颗粒度，MINUTE、HOUR、DAY、MONTH、YEAR

energyConversion

string

能源折算，0 用量

必需

energyTypeId

string

能源类型id

必需

energyTypeCode

string

能源类型编码

必需

dimensionId

string

必需

能源维度id，如果为对象维度id为0

示例

{
  "energyObjs": [
    {
      "objectId": "1203004470997438464",
      "gradationId": "1203005280921735168",
      "name": "空调冷站用电",
      "pathName": "达实大厦/空调冷站用电",
      "dimensionId": "1203005192723910656"
    }
  ],
  "offset": 8,
  "startTime": 1730736000000,
  "endTime": 1731254400000,
  "dataGranularity": "HOUR",
  "energyConversion": "0",
  "energyTypeId": "1210219922706022400",
  "energyTypeCode": "01",
  "dimensionId": "1203005192723910656"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/bems/data-view/v1/energy-trend/trend?project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU' \
--header 'Content-Type: application/json' \
--data-raw '{
    "energyObjs": [
        {
            "objectId": "1203004470997438464",
            "gradationId": "1203005280921735168",
            "name": "空调冷站用电",
            "pathName": "达实大厦/空调冷站用电",
            "dimensionId": "1203005192723910656"
        }
    ],
    "offset": 8,
    "startTime": 1730736000000,
    "endTime": 1731254400000,
    "dataGranularity": "HOUR",
    "energyConversion": "0",
    "energyTypeId": "1210219922706022400",
    "energyTypeCode": "01",
    "dimensionId": "1203005192723910656"
}'

返回响应

🟢200成功

application/json

Body

lineCharts

array [object {9}]

必需

startTime

integer

开始时间

必需

endTime

integer

结束时间

必需

currentValue

integer

当前值

必需

yoyStartTime

integer

同比开始时间

必需

yoyEndTime

integer

同比结束时间

必需

yoyValue

integer

同比值

必需

ratioStartTime

integer

环比开始时间

必需

ratioEndTime

integer

环比结束时间

必需

ratioValue

integer

环比值

必需

dataGranularity

null

当前数据颗粒度

必需

objectName

string

对象名称

必需

energyTypeName

string

能源类型

必需

energyUnit

string

能源单位

必需

yearOrYearValue

integer

上年同比用量

必需

yearOrYearPercentage

number

必需

上年同比百分比(正数表示上升,负数表示下降)

ratioValue

integer

上期环比用量

必需

ratioPercentage

integer

必需

上期环比用百分比(正数表示上升,负数表示下降)

statisticsValue

integer

统计值

必需

maxValue

integer

最大值

必需

minValue

integer

最小值

必需

averageValue

number

平均值

必需

示例

{
  "lineCharts": [
    {
      "startTime": 1731254400000,
      "endTime": 1731258000000,
      "currentValue": 25,
      "yoyStartTime": 1699632000000,
      "yoyEndTime": 1699635600000,
      "yoyValue": 115,
      "ratioStartTime": 1731168000000,
      "ratioEndTime": 1731171600000,
      "ratioValue": 26,
      "deviceId": ""
    },
    {
      "startTime": 1731258000000,
      "endTime": 1731261600000,
      "currentValue": 27,
      "yoyStartTime": 1699635600000,
      "yoyEndTime": 1699639200000,
      "yoyValue": 112,
      "ratioStartTime": 1731171600000,
      "ratioEndTime": 1731175200000,
      "ratioValue": 25,
      "deviceId": ""
    },
    {
      "startTime": 1731261600000,
      "endTime": 1731265200000,
      "currentValue": 25,
      "yoyStartTime": 1699639200000,
      "yoyEndTime": 1699642800000,
      "yoyValue": 93,
      "ratioStartTime": 1731175200000,
      "ratioEndTime": 1731178800000,
      "ratioValue": 28,
      "deviceId": ""
    },
    {
      "startTime": 1731265200000,
      "endTime": 1731268800000,
      "currentValue": 27,
      "yoyStartTime": 1699642800000,
      "yoyEndTime": 1699646400000,
      "yoyValue": 94,
      "ratioStartTime": 1731178800000,
      "ratioEndTime": 1731182400000,
      "ratioValue": 26,
      "deviceId": ""
    },
    {
      "startTime": 1731268800000,
      "endTime": 1731272400000,
      "currentValue": 24,
      "yoyStartTime": 1699646400000,
      "yoyEndTime": 1699650000000,
      "yoyValue": 98,
      "ratioStartTime": 1731182400000,
      "ratioEndTime": 1731186000000,
      "ratioValue": 25,
      "deviceId": ""
    },
    {
      "startTime": 1731272400000,
      "endTime": 1731276000000,
      "currentValue": 27,
      "yoyStartTime": 1699650000000,
      "yoyEndTime": 1699653600000,
      "yoyValue": 93,
      "ratioStartTime": 1731186000000,
      "ratioEndTime": 1731189600000,
      "ratioValue": 27,
      "deviceId": ""
    },
    {
      "startTime": 1731276000000,
      "endTime": 1731279600000,
      "currentValue": 93,
      "yoyStartTime": 1699653600000,
      "yoyEndTime": 1699657200000,
      "yoyValue": 96,
      "ratioStartTime": 1731189600000,
      "ratioEndTime": 1731193200000,
      "ratioValue": 45,
      "deviceId": ""
    },
    {
      "startTime": 1731279600000,
      "endTime": 1731283200000,
      "currentValue": 501,
      "yoyStartTime": 1699657200000,
      "yoyEndTime": 1699660800000,
      "yoyValue": 202,
      "ratioStartTime": 1731193200000,
      "ratioEndTime": 1731196800000,
      "ratioValue": 414,
      "deviceId": ""
    },
    {
      "startTime": 1731283200000,
      "endTime": 1731286800000,
      "currentValue": 413,
      "yoyStartTime": 1699660800000,
      "yoyEndTime": 1699664400000,
      "yoyValue": 201,
      "ratioStartTime": 1731196800000,
      "ratioEndTime": 1731200400000,
      "ratioValue": 169,
      "deviceId": ""
    },
    {
      "startTime": 1731286800000,
      "endTime": 1731290400000,
      "currentValue": 575,
      "yoyStartTime": 1699664400000,
      "yoyEndTime": 1699668000000,
      "yoyValue": 246,
      "ratioStartTime": 1731200400000,
      "ratioEndTime": 1731204000000,
      "ratioValue": 117,
      "deviceId": ""
    },
    {
      "startTime": 1731290400000,
      "endTime": 1731294000000,
      "currentValue": 295,
      "yoyStartTime": 1699668000000,
      "yoyEndTime": 1699671600000,
      "yoyValue": 159,
      "ratioStartTime": 1731204000000,
      "ratioEndTime": 1731207600000,
      "ratioValue": 75,
      "deviceId": ""
    }
  ],
  "dataGranularity": null,
  "objectName": "达实大厦/空调冷站用电",
  "energyTypeName": "电",
  "energyUnit": "kWh",
  "yearOrYearValue": 1509,
  "yearOrYearPercentage": 34.7,
  "ratioValue": 977,
  "ratioPercentage": 108,
  "statisticsValue": 2032,
  "maxValue": 575,
  "minValue": 24,
  "averageValue": 184.7
}

🟠400400响应结构