map/docs/api/data.md

数据访问接口

API接口一览表

接口分类	接口描述	API接口	权限
数据查询	实时数据查询	/api/data/snapshot
	历史区间数据查询	/api/data/history
	历史断面数据查询	/api/data/history/snapshot

数据查询接口

实时数据查询

POST 请求接口

/api/data/snapshot

请求参数

[
    {
        "deviceId":"129476828342323",
        "attributes":["power","windSpeed","dailyUsageHours","monthlyUsageHours"]
    },
    {
        "deviceId":"129476828342324",
        "attributes":["power","windSpeed","dailyUsageHours","monthlyUsageHours"]
    }
    ......
]

入参描述

参数名	参数类型	可选	描述
deviceId	String	no	设备ID
attributes	StringArray	no	要查询实时数据的设备属性列表

PS: 当attributes为空时，返回所有属性。

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": {
        "129476828342323":{
            "power": 56.2,
            "windSpeed": 45.3,
            "dailyUsageHours": 20,
            "monthlyUsageHours": 78,
            ....
        },
        "129476828342324":{
            "power": 53.2,
            "windSpeed": 35.3,
            "dailyUsageHours": 10,
            "monthlyUsageHours": 48,
            ....
        }
    }
}

返参描述

data 中以字典的方式，返回查询的每个设备的属性的实时值。

历史区间数据查询

根据提供的开始时间及结束时间，查询指定设备在指定时间段内的历史数据。

POST 请求接口

/api/data/history

请求参数

{
    //开始时间
    "startTime": "123452435324242",
    //结束时间
    "endTime": "123452435924242",
    //查询设备列表
    "devices": [
        {
            //设备ID
            "deviceId":"129476828342323",
            //要查询的属性列表
            "attributes":["power","windSpeed"]
        },
        {
            "deviceId":"129476828342324",
            "attributes":["power","dailyUsageHours"]
        }
    ],
    "interval": "1h"
}

入参描述

参数名	参数类型	可选	描述
startTime	String	no	开始时间戳
endTime	String	no	结束时间戳
devices.deviceId	String	no	设备ID
devices.attributes	StringArray	no	要查询实时数据的设备属性列表
interval	String	yes	抽样间隔,1a(毫秒),1s(秒),1m(分),1h(小时),1d(天),1w(周)。 忽略或者值为空时，返回原始数据（不抽样）
endTime	String	no	结束时间戳

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": {
        //设备ID
        "129476828342323":{
            //属性名
            "power": {
                //时间戳列表
                "times": [123452435924242,123452435924342,123452435924442,123452435924542],
                //值列表
                "values": [123.23,35.21,34.56,67]
            } ,
            //属性名
            "windSpeed": {
                "times": [123452435924242,123452435924342,123452435924442,123452435924542],
                "values": [123.23,35.21,34.56,67]
            } 
        },
        .......
    }
}