批量查询设备最新数据
请求方式:GET
URL: http://api.heclouds.com/devices/datapoints
URL请求参数
参数名称 |
格式 |
是否必须 |
说明 |
devIds |
string |
否 |
指定设备ID,多个用逗号分隔,最多1000个 |
返回参数
参数名称 |
格式 |
说明 |
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/int/json... |
数据点的值 |
请求示例
GET http://api.heclouds.com/devices/datapoints?devIds=20474930,23840492 HTTP/1.1
返回示例
{
"errno": 0,
"data": {
"devices": [{
"title": "test",
"id": "20474930",
"datastreams": [{
"at": "2017-12-22 10:30:22",
"id": "value",
"value": 1
}, {
"at": "2017-11-20 10:03:10",
"id": "0x01",
"value": {
"Header": {
"Cmdid": 1,
"DevType": 1
},
"Body": "3839383630326239383436",
"AcqTime": "17:11:15:13:26:4",
"LogSN": 3
}
}]
}, {
"title": "1",
"id": "23840492",
"datastreams": [{
"at": "2017-12-22 10:31:00",
"id": "value",
"value": 1
}]
}]
},
"error": "succ"
}