调用该接口查询设备级别的上报数据记录、统计聚合数据。
路径 | /datacenter/data/aggregate/query |
版本号 | 1.0.1 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 5000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
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."
}