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 的最后一个状态条目。在问号 ? 之后附加第一个参数。您可以使用 results 参数来控制返回的条目数,最多 8000 个。

https://api.thingspeak.com/channels/276330/status.json?results=3

读取 XML 格式的四个状态结果

在此示例中,格式指定为 XML。results 参数用于返回一定数量的条目,在本例中为四个。第一个参数附加在问号 ? 之后。

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