获取尖峰平谷能耗数据

开发中

POST

/api/open/bems/data-view/v1/external/peak-valley

最后修改时间：2024-08-01 10:25:40

责任人：未设置

请求参数

Query 参数

project

string

可选

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

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Timezone

string

时区

必需

示例值:

Asia/Shanghai

Authorization

string

可选

默认值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU

Body 参数application/json

startTime

integer

必需

开始时间戳，时间范围是左闭右开区间，即包含startTime指定的时间点，但不包含endTime指定的时间点

endTime

integer

必需

结束时间戳，时间范围是左闭右开区间，即包含startTime指定的时间点，但不包含endTime指定的时间点

dataGranularity

integer

必需

数据颗粒度：3 天（时间范围不能超过1个月）、5 月（时间范围不能超过1年）、6 YEAR（时间范围不能超过1年）

deviceIds

array[string]

必需

设备id集合，一次最多传100个

示例

{
  "startTime": 1721232000000,
  "endTime": 1721318400000,
  "dataGranularity": 2,
  "deviceIds": [
    "nybj1",
    "nybj2"
  ]
}

示例代码

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/peak-valley?project=1192410229407772672&instance=' \
--header 'Timezone: Asia/Shanghai' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU' \
--header 'Content-Type: application/json' \
--data-raw '{
  "startTime": 1721232000000,
  "endTime": 1721318400000,
  "dataGranularity":2,
  "deviceIds": [
    "nybj1",
    "nybj2"
  ]
}'

返回响应

🟢200成功

application/json

Body

pointed

array [object {2}]

尖

可选

deviceId

string

设备id

必需

val

number

可选

能耗用量（保留两位小数）

peak

array [object {2}]

峰

可选

deviceId

string

设备id

必需

val

number

可选

能耗用量（保留两位小数）

flat

array [object {2}]

平

可选

deviceId

string

设备id

必需

val

number

可选

能耗用量（保留两位小数）

valley

array [object {2}]

谷

可选

deviceId

string

设备id

必需

val

number

可选

能耗用量（保留两位小数）

time

number

时间戳

必需

示例

{
  "pointed": [],
  "peak": [
    {
      "deviceId": "nybj1",
      "val": 0.1
    }
  ],
  "flat": [
    {
      "deviceId": "nybj1",
      "val": 0.1
    }
  ],
  "valley": [
    {
      "deviceId": "nybj1",
      "val": 0.1
    }
  ],
  "time": 1721318400000
}

🟠400400响应结构

能源统计

获取能耗维度