导航中心

API文档 (版本1.0,版本 v1.1 测试中)

历史数据

API列表
/v1.0/device/<device_id>/sensor/<sensor_id>.json?start=<timestamp>&end=<timestamp>&interval=<interval>&page=<page>历史数据在线调试

历史数据

对该URL的一个HTTP GET请求将返回指定时间段的数据.

URL

http://api.yeelink.net/v1.0/device/<device_id>/sensor/<sensor_id>.json?start=<timestamp>&end=<timestamp>&interval=<interval>&page=<page>

请求参数

参数名 必需 类型 说明
device_id true string 设备ID
sensor_id true string 传感器ID
start false string 开始时间
end false string 结束时间
interval false int 数据采样间隔
page false int 数据分页,默认为1,200条/页

数据采样间隔说明

Interval 说明
1 每一秒取一个点
30 每30秒取一个点
60 每一分钟取一个点
300 每5分钟取一个点
900 每15分钟取一个点
1800 每30分钟取一个点
3600 每一小时取一个点
10800 每3小时取一个点
21600 每6小时取一个点
43200 每12小时取一个点
86400 每24小时取一个点

Method

GET

返回值

指定时间段的数据

返回数据格式

JSON

返回数据格式说明

  • 数值型传感器
  • gps型传感器
  • 图像型传感器
  • 微博抓取器
  • [
      {"timestamp": "2012-06-15T14:00:00", "value":315},
      {"timestamp": "2012-06-15T14:00:10", "value":316},
      {"timestamp": "2012-06-15T14:00:20", "value":317},
      {"timestamp": "2012-06-15T14:00:30", "value":317},
      {"timestamp": "2012-06-15T14:00:40", "value":317}
    ]
  • [
      {"timestamp": "2012-06-15T14:00:00", "value":{"lat":35.4,"lng":46.1,"speed":98.2}},
      {"timestamp": "2012-06-15T14:00:10", "value":{"lat":34.1,"lng":76.3,"speed":78.9}},
      {"timestamp": "2012-06-15T14:00:20", "value":{"lat":36.6,"lng":56.1,"speed":99.3}},
      {"timestamp": "2012-06-15T14:00:30", "value":{"lat":33.4,"lng":46.34,"speed":120}},
      {"timestamp": "2012-06-15T14:00:40", "value":{"lat":35.4,"lng":46.1,"speed":98.2}}
    ]
  • [
      {"timestamp": "2012-03-15T16:13:14", "value":{"size":45,"width":240,"height":320,"type":"jpg"}},
      {"timestamp": "2012-03-15T16:13:24", "value":{"size":180,"width":100,"height":320,"type":"png"}},
      {"timestamp": "2012-03-15T16:13:34", "value":{"size":1024,"width":480,"height":360,"type":"gif"}},
      {"timestamp": "2012-03-15T16:13:44", "value":{"size":2000,"width":240,"height":320,"type":"jpg"}},
    ]
  • 不支持

访问授权

需要在HTTP Header中增加API Key来授权GET操作, 具体请参照API Key.

请求实例

  • CURL
  • curl --request GET --header "U-ApiKey: YOUR_API_KEY_HERE" http://api.yeelink.net/v1.0/device/1/sensor/1.json?start=2012-06-02T14:01:46&end=2012-06-15T15:21:40&interval=1&page=1

快速导航