91 lines
3.1 KiB
Plaintext
91 lines
3.1 KiB
Plaintext
查询设备数据点
|
||
最近更新时间：2026-01-16 16:47:29
|
||
接口功能
|
||
根据产品id和设备名称查询，时间范围参数，查询设备历史数据点信息
|
||
|
||
备注
|
||
仅支持数据流、IPSO数据协议，设备能正常下发上报
|
||
|
||
接口地址
|
||
http(s)://iot-api.heclouds.com/datapoint/history-datapoints
|
||
|
||
API说明
|
||
请求方式：GET
|
||
|
||
http query 请求参数：
|
||
|
||
参数 类型 是否必选 描述
|
||
datastream_id string 否 数据流ID，多个id之间用逗号分开，缺省时取数据流或数据流模板100条为缺省数据流id条件
|
||
product_id string 是 产品ID，平台生成唯一ID
|
||
device_name string 是 设备名称
|
||
imei string 否 lwm2m协议时传，设备imei
|
||
start string 否 提取数据点的开始时间，精确到秒，示例：2015-01-10T08:00:35
|
||
end string 否 提取数据点的结束时间，精确到秒，示例：2015-01-10T08:00:35
|
||
duration int 否 查询时间区间，单位为秒
|
||
limit int 否 限定本次请求最多返回的数据点数，默认100，范围为(0,6000]
|
||
cursor string 否 指定本次请求继续从cursor位置开始提取数据
|
||
sort enum 否 时间排序方式，DESC：倒序，ASC：升序，默认为DESC
|
||
返回数据
|
||
|
||
参数名称 类型 描述
|
||
code int 调用成功或失败时，返回的code码
|
||
msg string 调用成功或失败时，返回的msg信息
|
||
request_id string 调用API生成的请求标识
|
||
data - 调用成功时，返回的业务数据
|
||
data.count int 本次返回的数据点数量
|
||
data.cursor string 本次请求若未能返回所有数据，则会返回cursor参数，用户可以携带cursor参数进行再次请求，获取剩下的数据
|
||
data.datastreams array-json 设备数据流信息的json数组，见datastreams描述
|
||
datastreams描述表
|
||
|
||
参数名称 格式 说明
|
||
id string 数据流名称
|
||
datapoints array-json 数据点信息的json数组，见datapoints描述表
|
||
datapoints描述表
|
||
|
||
参数名称 格式 说明
|
||
at string 数据记录时间
|
||
value string/int/json... 数据点的值
|
||
特别说明
|
||
|
||
当start，end时间均为空
|
||
i) limit
|
||
不传值或传值等于1时：排序为升序则查询最早一个数据点（30天内），否则查询最新数据点（最新缓存数据）
|
||
|
||
ii) limit
|
||
传值大于1时：排序为升序则查询最早x条数据点，否则查询最新x条数据点（30天内，x=limit）
|
||
|
||
示例
|
||
请求示例
|
||
|
||
GET http(s)://iot-api.heclouds.com/datapoint/history-datapoints
|
||
?product_id=XhONWQ5zV5&device_name=mqtts-dev&datastream_id=ds&start=2017-01-01T00:00:00&limit=100
|
||
响应示例
|
||
|
||
{
|
||
"data":{
|
||
"cursor":"25971_564280_1448961152173",
|
||
"count":5,
|
||
"datastreams":[
|
||
{
|
||
"datapoints":[
|
||
{
|
||
"at":"2015-12-01 17:10:24.981",
|
||
"value":"35"
|
||
},
|
||
{
|
||
"at":"2015-12-01 17:10:53.406",
|
||
"value":"38"
|
||
},
|
||
...
|
||
],
|
||
"id":"3200_0_5501"
|
||
},
|
||
...
|
||
]
|
||
},
|
||
"request_id": "a25087f46df04b69b29e90ef0acfd115",
|
||
"msg": "succ",
|
||
"code": 0
|
||
}
|
||
|