批量查询设备最新数据
请求方式:GET
URL: http://api.heclouds.com/devices/datapoints
url参数
参数名称 |
格式 |
是否必须 |
说明 |
devIds |
string |
是 |
设备ids,用逗号隔开,最多限制500个设备 |
返回参数
参数名称 |
格式 |
说明 |
errno |
int |
调用错误码,为0表示调用成功 |
error |
string |
错误描述,为"succ"表示调用成功 |
data |
json |
接口调用成功之后返回的设备数据相关信息,见data描述表 |
data描述表
参数名称 |
格式 |
说明 |
devices |
array-json |
设备最新数据的json数组,见devices描述表 |
devices描述表
参数名称 |
格式 |
说明 |
id |
string |
设备id |
title |
string |
设备名 |
datastreams |
array-json |
数据流的最新数据的json数组,见datastreams描述表 |
datastreams描述表
参数名称 |
格式 |
说明 |
id |
string |
数据流名称 |
at |
string |
时间 |
value |
string |
最新数据值 |
请求示例
GET http://api.heclouds.com/devices/datapoints?devIds=12323,12324 HTTP/1.1
api-key: WhI*************v1c=
Content-Type: application/json
Host: api.heclouds.com
返回示例
{
"errno": 0,
"data": {
"devices":[
{
"id":12323,
"title":"daf",
"datastreams":[
{
"id":"temperature",
"at":"2017-02-12 10:22:22",
"value":"12"
},
...
]
},
{
"id":12324,
"title":"daf",
"datastreams":[
{
"id":"temperature",
"at":"2017-02-12 10:22:22",
"value":"15"
},
...
]
},
...
]
},
"error": "succ"
}