获取空间数据 九月 29, 2017

功能描述

获取空间数据(Get Channel Feed)接口是用来读取指定空间(channel)所存储的传感器感知数据。

注意: 由于设备的传感器采样率每个相对独立,例如温湿度5分钟采集一次,光照10分钟采集一次,所以接口返回的数据中不是每个时间点timestamp都有对应传感器数据值。 

请求方式

HTTP GET

请求地址

GET http://api.ubibot.cn/channels/CHANNEL_ID/feeds.json  

将以上URL中的CHANNEL_ID替换成空间编号。若需要返回数据为CSV格式:

GET http://api.ubibot.cn/channels/CHANNEL_ID/feeds.csv

请求参数

名称 类型 是否必须 描述
api_key或 account_key String 根据空间权限决定 指定空间的写入或读取密钥,(公开空间不需要密钥) ,或使用account_key可对所有空间进行管理
entry_id String 若为true,则返回中增加entry_id, 默认为false(不返回)
results Integer 需要查询的条目数。最多8000 。
start Datetime 检索开始时间,格式 YYYY-MM-DD%20HH:NN:SS
end Datetime 检索结束时间,格式 YYYY-MM-DD%20HH:NN:SS
status Boolean Include status updates in feed by setting
timezone String 检索的时区
min Decimal 返回数据的最小值
max Decimal 返回数据的最大值
sum String 按指定分钟数作为时间间隔返回合计数值。 仅支持有效值为:10, 15, 20, 30, 60, 240, 720, 1440, “daily” 。
average String 按指定分钟数作为时间间隔返回平均数值。 仅支持有效值为:10, 15, 20, 30, 60, 240, 720, 1440, “daily” 。
round Integer Round to this many decimal places (optional)
callback String JSONP 跨域请求的方法名

返回说明

  • 若返回中is_truncated为true, 表明此请求的时间区间段内还有更多数据,由于最大返回值限制,无法返回全部数据。
  • 返回中timezone为默认或指定请求的时区名。
  • channel_id为每个空间的唯一编号

调用示例

GET http://api.ubibot.cn/channels/CHANNEL_ID/feeds.csv?api_key=xxxxx-xxxxx-xxxxx-xxxx

GET http://api.ubibot.cn/channels/CHANNEL_ID/feeds.csv?account_key=xxxxx-xxxxx-xxxxx-xxxx

示例代码(PHP)

导出全部空间数据

功能描述

导出全部空间数据(Export All Channel Feeds)接口是用来以CSV形式导出指定空间(channel)所存储的所有传感器感知数据。

请求地址

http://api.ubibot.cn/channels/CHANNEL_ID/full_feeds.csv

将CHANNEL_ID替换成空间编号。若需要返回数据为CSV格式:

请求方式

HTTP GET

注意事项

由于全部导出功能会对平台产生流量及带宽波动,所以全部导出接口目前对于每个设备每月会有相应次数限制。