Read Status
使用 HTTP GET 读取通道状态字段
请求
HTTP 方法
GET
URL
https://api.thingspeak.com/channels/
<channel_id>
/status.<format>
URL 参数
名称 | 描述 |
---|---|
| (必填)感兴趣通道的通道 ID。 |
| (可选)HTTP 响应的格式,指定为 |
示例: https://api.thingspeak.com/channels/266256/status.json
查询字符串参数
名称 | 描述 | 值类型 |
---|---|---|
api_key | (私有通道必需)为此特定通道指定读取 API 密钥。读取 API 密钥位于通道视图的 API Keys 选项卡上。 | 字符串 |
results | (可选)要检索的条目数,最多 8000 个。 | 整数 |
days | (可选)响应中包含的从现在开始之前的 24 小时时段数。默认值为 1。 | 整数 |
timezone | (可选)来自 时区参考 的此请求的标识符。 | 字符串 |
offset | (可选)显示结果的时区偏移量。使用时区参数可获得更高的准确性。 | 整数 |
提示
results
参数决定查询所检索的最大条目数,最多为 8000 个。默认时间跨度限制为 1 天(24 小时)。要获取超过 1 天的结果并限制条目,请同时使用 results
和 days
参数。
示例
您可以使用 Web 浏览器对 ThingSpeak™ 的 RESTful API 完成 GET HTTP 请求。要查看 HTTP 响应的格式,请点击链接或将其复制到您的浏览器。
读取 JSON 格式的三种状态结果
通道 276330 存储办公室植物的土壤湿度信息。您可以从这个公共通道读取数据。响应的格式出现在 URL 的末尾,在任何查询字符串参数之前。此示例以 JSON
格式返回来自通道 276330 的最后一个状态条目。在问号后追加第一个参数 ?
。您可以使用结果参数来控制返回的条目数,最多 8000 个。
https://api.thingspeak.com/channels/276330/status.json?results=3
以 XML 格式读取四种状态结果
在此示例中,格式指定为 XML
。结果参数用于返回一定数量的条目,在本例中为四个。第一个参数附加在问号 ?
后面。
https://api.thingspeak.com/channels/276330/status.xml?results=4
以 CSV 格式读取私人通道中的五个状态结果
当您以 csv
格式请求输出时,返回的文件是逗号分隔的变量格式。根据您的计算机配置,您的浏览器可以打开其他软件来显示此格式。要从私有通道读取数据,请在参数 api_key
后提供读取 API 密钥。在问号后追加第一个参数 ?
。使用与号 &
追加第二个参数。在这种情况下,results
参数用于返回五个结果。
https://api.thingspeak.com/channels/276330/status.csv?api_key=E52AWRAV1RSXQQJW&results=5