历史数据查询

根据设备点位查询模拟数据和实测数据，可以一次性查询多个。当IsSearchSimul为false时，则仅查询实测数据，返回值中ModelTsData将为null；如果需要查询模拟数据，则参数中LibraryId必填。
设备指标的模拟数据是指在做模型点位映射时，设备指标绑定的模型输出点位的模拟结果。如果没有模型结果绑定到该查询指标，则返回值中ModelTsData将为null。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

array of:

isSearchMeasure

boolean

必需

是否查询实测历史数据

isSearchSimul

boolean

必需

是否查询模拟历史数据

libraryId

string <uuid> | null

可选

方案类库Id,即:模拟场景，如滚动预报、调度优化、情景模拟等;若IsSearchSimul为true,此字段必填，方案库的数据在初始化租户时生成，可通过方案管理服务来获取具体数据，方案管理服务上的接口为/api/v1/scenario-manager/library/list

deviceCode

string | null

可选

要查询的设备名称, 如果Indicator在整个系统中唯一，则可以留空，否则不能留空

indicator

string

必需

查询的设备的指标Code，如：Device1_COD

>= 1 字符

startTs

string <date-time>

必需

查询的数据的开始时间

endTs

string <date-time>

必需

查询的数据的结束时间

orderBy

string | null

可选

排序方式，ASC (升序)，DESC (降序) ;默认是降序DESC

sample

string | null

可选

查询是否抽样, 如果不需要抽样，则留空，否则需要填写固定值'minutes'，按分钟抽样，取整分钟的数据，暂时仅支持按分钟抽样。

interval

integer <int32>

可选

抽样频率,如:sample=minutes,interval=5,表示按照5分钟进行抽样，每5分钟取一条数据，取满足条件时间的分钟数对5取余为0的记录

示例

[
    {
        "isSearchMeasure": true,
        "isSearchSimul": true,
        "libraryId": "6780430a-772c-4fd6-a7b1-5dc852e6898f",
        "deviceCode": "string",
        "indicator": "string",
        "startTs": "2019-08-24T14:15:22Z",
        "endTs": "2019-08-24T14:15:22Z",
        "orderBy": "string",
        "sample": "string",
        "interval": 0
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

text/plain

Success

Body

indicators

array[object (SearchIndicator) {8}] | null

查询的指标

可选

isSearchMeasure

boolean

是否查询实测数据

可选

isSearchSimul

boolean

是否查询模拟数据

可选

indicator

string | null

查询到设备指标

可选

deviceCode

string | null

查询的设备名称

可选

libraryId

string <uuid> | null

可选

模拟数据对应的方案库的数据

label

string | null

指标标签

可选

showName

string | null

指标的中文显示名

可选

unit

string | null

指标单位

可选

measureTsData

array[object (TimeseriesBatchForV3Output) {4}] | null

实测历史数据

可选

array[string] | null

可选

array | null

可选

deviceCode

string | null

设备编码、设备名称

可选

indicator

string | null

指标编码

可选

modelTsData

array[object (ModelResultOutput) {5}] | null

模拟历史数据

可选

array[string] | null

可选

array[number <double>] | null

可选

deviceCode

string | null

设备编码

可选

indicator

string | null

指标

可选

modelFeatureId

string | null

模型中的点位Id

可选

示例

{
    "indicators": [
        {
            "isSearchMeasure": true,
            "isSearchSimul": true,
            "indicator": "string",
            "deviceCode": "string",
            "libraryId": "6780430a-772c-4fd6-a7b1-5dc852e6898f",
            "label": "string",
            "showName": "string",
            "unit": "string"
        }
    ],
    "measureTsData": [
        {
            "t": [
                "string"
            ],
            "v": [
                null
            ],
            "deviceCode": "string",
            "indicator": "string"
        }
    ],
    "modelTsData": [
        {
            "t": [
                "string"
            ],
            "v": [
                0
            ],
            "deviceCode": "string",
            "indicator": "string",
            "modelFeatureId": "string"
        }
    ]
}