调用该接口查询设备级别的上报数据记录、统计聚合数据。

路径 /datacenter/data/aggregate/query
版本号 1.0.1
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
cols JSON {} 查询条目。
tableName String 表的名称。
expr JSON {} 查询条件。其中包含以下参数:op(and/or)、filters(多个过滤对象)、exprs(多个查询表达式对象数组,exprs表示一个或多个expr(expr中可以嵌套expr,嵌套的expr个数不限)。)
orderBy JSON {} 排序方式。参数含义:col(列名);type(类型);asc(升序);desc(降序)。示例:[{“col”:“id”,“type”:“asc”}]。
pageNo Int 分页位置,从1开始。
pageSize Int 分页大小。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

data String

自建表查询结果。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.1",
		"iotToken": "token"
	},
	"params":{
		"iotId": "value0",
		"cols":{},
		"tableName": "value2",
		"expr":{},
		"orderBy":{},
		"pageNo": "value5",
		"pageSize": "value6"
	}
}

正常返回示例

JSON 格式

{
    "code": 200,
    "data": [
        {
            "dim_time": "2017-10-1715:35:00",
            "city_name": "北京",
            "temperature": 10.1,
            "id": 1
        },
        {
            "dim_time": "2017-10-1716:35:00",
            "city_name": "上海",
            "temperature": 15.1,
            "id": 2
        },
        {
            "dim_time": "2017-10-1800:00:00",
            "city_name": "杭州",
            "temperature": 16.1,
            "id": 3
        }
    ]
}

异常返回示例

JSON 格式

{
"code":460,
"message":"request parameter error."
}