云服务 API 参考行业场景垂直行业解决方案智慧工业生产能耗分析数据统计分析查询数据点概况

查询数据点概况

更新时间：2023-06-21 07:13:10下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_type_codes	String	query	true	类型编号

返回参数

参数名	类型	说明
result	List	返回结果说明

result 说明

参数名	类型	说明
today_data	Double	今日数据
compared_yesterday	Double	环比昨日
month_data	Double	当月数据
compared_last_month	Double	环比上月
year_data	Double	当年数据
compared_last_year	Double	环比去年
device_type_name	String	设备类别名称
device_type_code	String	设备类别编号
unit	String	单位

请求示例

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
}

错误码

参考错误码。

上一篇查询数据概况图表数据

下一篇查询数据统计