sensor/getHistoryData

获取测量设备历史数据

URL

http://www.lewei50.com/api/v1/sensor/GetHistoryData/你的测量设备ID

是否需要Userkey

参数

  必选 默认值 类型 范围 介绍
StartTime 2000-01-01 datetime 小于当前时间 起始时间
EndTime 当前时间 datetime 截止时间
Interval 1 int 大于1 间隔多少秒取一次数据
Start 0 int 从第{start}条开始取数据
Limit 1000 int 1-1000 一次取多少条数据
Order 1 int 0或1 0表示倒叙1表示正序

获取方式

get

返回格式

json

返回结果实例

{
    "Data": [
        {
            "updateTime": "2012-08-22T21:15:18", 
            "value": 22
        }, 
        {
            "updateTime": "2012-08-22T22:11:28", 
            "value": 22
        }, 
        {
            "updateTime": "2012-08-23T10:51:31", 
            "value": 22
        }
    ], 
    "Successful": true, 
    "Message": null
}

返回字段说明

  类型 介绍
Successful boolean 是否查询成功
Message string 出错时返回错误信息
Data/updateTime string 数据更新时间
Data/value string 数据值

注意事项&详细说明

测量设备ID为全局标识,非idName,可以通过该API:user/getSensorsWithGateway (http://www.lewei50.com/dev/apiinfo/2)获得,也就是其中sensors/id的值
时间格式为:ISO 8601。

关于分页:
    如果一次没有取完所有数据,使用Start参数来获取下一页数据,比如Start传1000的时候,会略过1000条已取的数据,返回1001-2000之间的数据。

关于排序:
    如果需要按时间倒序取数据,比如取最近1000条的数据,需要传递Order=0。

API在线测试工具

在线测试