功能描述

获取空间汇总数据(Get Channel Feed Summaries)接口用于从指定空间(channel)中的所有传感器字段读取汇总数据。此方法可以返回JSON或CSV对象。每个汇总数据记录由每小时的总和、平均值、记录数量、标准差、每个字段的最大值和最小值组成。

请求地址

返回JSON对象:

https://api.ubibot.cn/channels/CHANNEL_ID/summary.json?parameters

返回CVS文件格式: (即将推出)

http://api.ubibot.cn/channels/CHANNEL_ID/summary.csv?parameters 

将以上URL中的CHANNEL_ID替换成空间编号。

请求方式

GET

请求参数

名称 类型 是否必须 描述
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
timezone String 此请求的时区引用的标识符。
callback String 用于JSONP跨域请求的函数名。

返回说明

返回 200 即成功。Body包含一个JSON对象,其中包含请求格式的汇总数据若返回中is_truncated为true, 表明此请求的时间区间段内还有更多数据,由于最大返回值限制,无法返回全部数据。您可以更改起始值和结束值来缩小范围。

错误:详细信息请参阅错误代码列表。

调用示例

GET https://api.ubibot.cn/channels/123/summary?api_key=XXXXXXXXXXXXX

返回JSON对象,例如:

示例代码(PHP)