查询数据点概况

更新时间:2023-06-15 06:01:20

本文介绍查询数据点概况的 API。

接口描述

查询租户所有设备类型的数据点概况。

接口地址

GET: /v1.0/iot-03/si/datapoint/analysis/survey

请求参数

参数名类型参数位置是否必填说明
device_type_codesStringquerytrue类型编号

返回参数

参数名类型说明
resultList返回结果说明

result 说明

参数名类型说明
today_dataDouble今日数据
compared_yesterdayDouble环比昨日
month_dataDouble当月数据
compared_last_monthDouble环比上月
year_dataDouble当年数据
compared_last_yearDouble环比去年
device_type_nameString设备类别名称
device_type_codeString设备类别编号
unitString单位

请求示例

GET: /v1.0/iot-03/si/datapoint/analysis/survey?device_type_codes=water,GAS,electric

返回示例

{
    "result": [
        {
            "today_data": 0,
            "device_type_name": "电",
            "compared_last_month": 1,
            "month_data": 228.43,
            "compared_yesterday": -1,
            "year_data": 228.43,
            "unit": "KWH",
            "device_type_code": "electric",
            "compared_last_year": 1
        },
        {
            "today_data": 0,
            "device_type_name": "气",
            "compared_last_month": 1,
            "month_data": 22.755,
            "compared_yesterday": -1,
            "year_data": 22.755,
            "unit": "Nm³",
            "device_type_code": "GAS",
            "compared_last_year": 1
        },
        {
            "today_data": 0,
            "device_type_name": "水",
            "compared_last_month": 1,
            "month_data": 22.743,
            "compared_yesterday": -1,
            "year_data": 22.743,
            "unit": "T",
            "device_type_code": "water",
            "compared_last_year": 1
        }
    ],
    "t": 1635498073214,
    "success": true
}

错误码

参考 错误码