Main Content

本页采用了机器翻译。点击此处可查看英文原文。

Read Status

使用 HTTP GET 读取通道状态字段

请求

HTTP 方法

GET

URL

https://api.thingspeak.com/channels/<channel_id>/status.<format>

URL 参数

名称描述

<channel_id>

(必填)感兴趣通道的通道 ID。

<format>

(可选)HTTP 响应的格式,指定为 jsonxmlcsv

示例: 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 天的结果并限制条目,请同时使用 resultsdays 参数。

响应

成功

HTTP 状态代码

200 OK

如果您无权访问该通道,则响应为 -1。

主体

 JSON 示例

 XML 示例

 CSV 示例

错误

完整列表请参阅错误代码

如果您无权访问该通道,则响应为 -1。

示例

您可以使用 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