新增数据点
请求方式:POST
URL:http://api.heclouds.com/devices/device_id/datapoints
device_id:需要替换为设备ID
url参数
参数名称 |
格式 |
是否必须 |
说明 |
type |
string |
否 |
数据格式,默认为完整JSON型(见示例) |
http body参数
参数名称 |
格式 |
是否必须 |
说明 |
datastreams |
array-json |
是 |
设备数据流信息的json数组,见datastreams描述表 |
datastreams描述表
参数名称 |
格式 |
是否必须 |
说明 |
id |
string |
是 |
数据流或者数据流模板名称 |
datapoints |
array-json |
是 |
数据点。可以一次性向设备云上传多个数据流,每个数据流中可以包括多个数据点,见datapoints描述表 |
datapoints描述表
参数名称 |
格式 |
是否必须 |
说明 |
at |
date |
否 |
上传数据点时间。如果为空,则设备云会取当前时间。如果存在其格式必须为"YYYY-MM-DDThh:mm:ss"的形式(例如:2015-03-22T22:31:12) |
value |
string/int/json... |
是 |
数据的值 |
请求头部示例
POST http://api.heclouds.com/devices/2*****30/datapoints HTTP/1.1
请求参数示例
{
"datastreams": [{
"id": "temperature",
"datapoints": [{
"at": "2013-04-22T00:35:43",
"value": "bacd"
},
{
"at": "2013-04-22T00:55:43",
"value": 84
}
]
},
{
"id": "key",
"datapoints": [{
"at": "2013-04-22T00:35:43",
"value": {
"x": 123,
"y": 123.994
}
},
{
"at": "2013-04-22T00:35:43",
"value": 23.001
}
]
}
]
}
返回示例
{
"errno": 0,
"error": "succ"
}