主要内容

阅读领域

读取数据从单一领域的通道与HTTP GET

请求

HTTP方法

得到

URL

https://api.thingspeak.com/channels/< channel_id >/ /字段< field_id ><格式>

URL参数

的名字 描述

< channel_id >

(必需)通道ID感兴趣的频道,指定为一个整数。

< field_id >

(需要)字段ID感兴趣的频道。

<格式>

HTTP响应(必需的)格式,指定为json,xml,或csv

例子: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年,“日常”。注意:值解释为0在计算平均值。

整数或字符串

中位数

(可选)得到的中值这么多分钟,有效值: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.csv?start=2011 - 2010:10:10&end = 2011-11-11 - 11 - 11% % 2011:11:11

读了一天的结果以文本格式

https://api.thingspeak.com/channels/9/fields/1?api_key=E52AWRAV1RSXQQJW

ThingSpeak返回数据的最后一天,8000点,当没有指定其他参数。

响应

成功

HTTP状态代码

200好了

如果你没有访问通道,响应是1。

身体

JSON的例子

XML的例子

CSV例子

错误

的完整列表,请参阅错误代码

如果你没有访问通道,响应是1。