批量查询设备最新数据
请求方式:GET
URL: http(s)://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
返回示例
{
"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"
}