Read Data
使用 HTTP GET 读取通道中所有字段的数据
请求
HTTP 方法
GET
URL
https://api.thingspeak.com/channels/
<channel_id>
/feeds.<format>
URL 参数
名称 | 描述 |
---|---|
| (必填)感兴趣通道的通道 ID。 |
| (必需)HTTP 响应的格式,指定为 |
示例: https://api.thingspeak.com/channels/266256/feeds.json
查询字符串参数
名称 | 描述 | 值类型 |
---|---|---|
api_key | (私有通道必需)。为此特定通道指定读取 API 密钥。读取 API 密钥位于通道视图的 API Keys 选项卡上。 | 字符串 |
results | (可选)要检索的条目数。最大数量为 8,000。 | 整数 |
days | (可选)响应中包含的从现在开始之前的 24 小时时段数。默认值为 1。 | 整数 |
minutes | (可选)响应中包含的从现在开始的 60 秒时间段的数量。默认值为 1440。 | 整数 |
start | (可选)开始日期,格式为 YYYY-MM-DD%20HH:NN:SS。 | 日期时间 |
end | (可选)结束日期,格式为 YYYY-MM-DD%20HH:NN:SS。 | 日期时间 |
timezone | (可选)来自 时区参考 的此请求的标识符。 | 字符串 |
offset | (可选)显示结果的时区偏移量。使用时区参数可获得更高的准确性。 | 整数 |
status | (可选)通过设置 "status=true" 在源中包含状态更新。 |
|
metadata | (可选)通过设置 "metadata=true" 来包含通道的元数据。 |
|
location | (可选)通过设置 "location=true" 在源中包含纬度、经度和海拔。 |
|
min | (可选)响应中包含的最小值。 | 小数 |
max | (可选)响应中包含的最大值。 | 小数 |
round | (可选)四舍五入到小数点后这么多位。 | 整数 |
timescale | (可选)获取这些分钟内的第一个值,有效值:10、15、20、30、60、240、720、1440、"daily"。 | 整数或字符串 |
sum | (可选)获取这些分钟的总和,有效值:10、15、20、30、60、240、720、1440、"daily"。 | 整数或字符串 |
average | (可选)获取这些分钟的平均值,有效值:10、15、20、30、60、240、720、1440、"daily"。注意:计算平均值时, | 整数或字符串 |
median | (可选)获取这些分钟的中位数,有效值:10、15、20、30、60、240、720、1440、"daily"。 |
|
提示
results
参数具有最高优先级。将 results
与参数 min
、max
、timescale
、sum
、average
或 median
一起使用可能会导致返回少于 8000 条记录。results
参数决定查询所使用的最大条目数,最多为 8000 个。例如,考虑一个每分钟更新一次的通道。对该通道使用参数 ?results=120&sum=60
的读取请求仅返回两条记录,而不是 120 条。请参阅示例读取两小时的 JSON 格式的条目并计算平均值。
示例
您可以使用 Web 浏览器对 ThingSpeak™ 的 RESTful API 完成 GET HTTP 请求。要查看 HTTP 响应的格式,请点击链接或将其复制到您的浏览器。
读取 JSON 格式的三个条目
第 9 通道包含来自多个家庭环境传感器的信息。您可以从这个公共通道读取数据。响应的格式出现在 URL 的末尾,在任何查询字符串参数之前。在问号后追加第一个参数 ?
。您可以使用 results 参数来控制返回的条目数,最多可达 8000 个。
读取 JSON 格式的两小时条目并计算平均值
第 9 通道包含来自多个家庭环境传感器的信息,每分钟更新一次。您可以从这个公共通道读取数据。响应的格式出现在 URL 的末尾,在任何查询字符串参数之前。在问号后追加第一个参数 ?
。您可以使用结果参数来控制返回的条目数,最多 8000 个。在此请求中,120 个结果被平均分为两个响应。
https://api.thingspeak.com/channels/9/feeds.json?results=120&average=60
读取 XML 格式的四个条目
在此示例中,格式指定为 XML
。结果参数用于返回一定数量的条目,在本例中为四个。第一个参数附加在问号 ?
后面。
以 JSON 格式从私人通道读取五条条目
要从私有通道读取数据,请提供带有参数 api_key
的读取 API 密钥。在问号后追加第一个参数 ?
。在与号 &
后追加第二个参数。在这种情况下,results
用于请求五个结果。
https://api.thingspeak.com/channels/9/feeds.json?api_key=E52AWRAV1RSXQQJW&results=5
以 CSV 格式读取日期范围的事件
当您以 csv
格式请求输出时,返回的文件是逗号分隔的变量格式。根据您的计算机配置,您的浏览器可以启动附加软件来显示这种格式。在此示例中,start
和 end
参数用于指定所请求数据的日期限制。