获取空间数据  2017年9月29日

功能描述

获取空间数据(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可对所有空间进行管理
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

 

若只获取最近一条空间数据(最后一个传感器的采集值)

注意:设备有多个传感器,每个传感器采样时间不一样,所以每个传感器的数据相当于1条。 用last操作,是读取最后一条,所以不一定是某个传感器的。 

请求地址

http://api.ubibot.cn/channels/CHANNEL_ID/feeds/last  

将CHANNEL_ID替换成空间编号。

请求方式

HTTP GET

请求参数

名称 类型 是否必须 描述
api_key或 token_id String 根据空间权限决定 指定空间的写入或读取密钥,(公开空间不需要密钥) ,与token_id(string)二选一
timezone String 检索的时区
callback String JSONP 跨域请求的方法名

返回说明

正常情况下,平台所返回JSON数据包形式如下:

 

导出全部空间数据

功能描述

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

请求地址

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

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

请求方式

HTTP GET

注意事项

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

轻松连官方微信

关注轻松连微信公众平台

官方客服电话:400-036-1016

业务咨询电话:0411-86686675