阅读领域
读取数据从单一领域的通道与HTTP GET
请求
HTTP方法
得到
URL
https://api.thingspeak.com/channels/
< channel_id >
/ /字段< field_id >
。<格式>
URL参数
的名字 | 描述 |
---|---|
|
(必需)通道ID感兴趣的频道,指定为一个整数。 |
|
(需要)字段ID感兴趣的频道。 |
|
HTTP响应(必需的)格式,指定为 |
例子:https://api.thingspeak.com/channels/266256/fields/2.json
查询字符串参数
的名字 | 描述 | 值类型 |
---|---|---|
api_key |
(所需的私人频道)为这个特定的通道指定阅读API密匙。Read API密匙上发现的API密钥通道的选项卡视图。 |
字符串 |
结果 |
(可选的)数量的条目检索。最大的号码是8000。 |
整数 |
天 |
(可选)的数量现在包括在反应前24小时的周期。缺省值是1。 |
整数 |
分钟 |
(可选)的数量现在包括在反应前60秒的时间。默认值是1440。 | 整数 |
开始 |
(可选)开始日期格式YYYY-MM-DD % 20 hh:神经网络:党卫军。 |
datetime |
结束 |
(可选)结束日期格式YYYY-MM-DD % 20 hh:神经网络:党卫军。 |
datetime |
时区 |
(可选)标识符时区参考对于这个请求。 |
字符串 |
抵消 |
(可选的)结果显示在的时区偏移。使用时区参数更大的准确性。 |
整数 |
状态 |
(可选)包括状态更新饲料通过设置“状态= true”。 |
|
元数据 |
(可选)包括元数据通道通过设置“元数据= true”。 |
|
位置 |
(可选)包括纬度、经度和海拔饲料通过设置“位置= true”。 |
|
最小值 |
(可选)最小值包含在响应。 |
|
马克斯 |
(可选)最大值在响应。 | 小数 |
轮 |
(可选)四舍五入到小数点后这么多。 |
整数 |
时间尺度 |
(可选)得到第一个值这么多分钟,有效值:10、15、20、30、60、240、720、1440年,“日常”。 |
整数或字符串 |
总和 |
(可选)得到的这么多分钟,有效值:10、15、20、30、60、240、720、1440年,“日常”。 |
整数或字符串 |
平均 |
(可选)得到的平均这么多分钟,有效值:10、15、20、30、60、240、720、1440年,“日常”。注意: |
整数或字符串 |
中位数 |
(可选)得到的中值这么多分钟,有效值:10、15、20、30、60、240、720、1440年,“日常”。 |
整数或 |
提示
的结果
参数具有最高的优先级。使用结果
与参数最小值
,马克斯
,时间尺度
,总和
,平均
,或中位数
会导致不到返回8000条记录。的结果
参数确定的最大条目数用于查询,8000。例如,考虑一个通道有一个每分钟更新。读请求通道的参数= 120金额= 60 ?结果
只返回两个记录,而不是120年。看这个例子读两个小时的条目以JSON格式和平均水平。
例子
您可以使用web浏览器来完成GET HTTP请求的RESTful API ThingSpeak™。HTTP响应的格式,点击链接或复制到你的浏览器。
读10以JSON格式的结果
9频道包含几个家庭环境的传感器信息。你可以阅读这个公共通道的单个字段的数据。格式的响应发生在URL的末尾,之前查询字符串参数。在这里请求的格式json
。附加一个问号后第一个参数吗?
。您可以使用参数控制结果返回的条目数,这是8000。
https://api.thingspeak.com/channels/9/fields/1.json?results=10
每10分钟读值为100 XML格式的结果
在这个例子中,被指定为XML格式。结果参数是用于返回一个指定数量的条目,在这种情况下10。
https://api.thingspeak.com/channels/9/fields/2.xml?results=100&median=10
读CSV格式的日期范围的事件
当你请求中的输出csv
格式,文件是一个逗号分隔的变量格式返回。根据你的电脑的配置,您的浏览器可以打开这种格式显示额外的软件。使用&&
添加第二个参数。在这个例子中,开始
和结束
参数用于指定日期限制所请求的数据。
读了一天的结果以文本格式
https://api.thingspeak.com/channels/9/fields/1?api_key=E52AWRAV1RSXQQJW
ThingSpeak返回数据的最后一天,8000点,当没有指定其他参数。