阅读状态

读取使用HTTP获取的频道状态字段

要求

HTTP方法

得到

URL

https://api.thingspeak.com/channels//地位。<格式>

URL参数

姓名	描述
	（必需）感兴趣的渠道ID。
`<格式>`	（可选）HTTP响应的格式，指定为`JSON`，，，，`XML`，或者`CSV`。

例子：https://api.thingspeak.com/channels/266256/status.json

查询字符串参数

姓名	描述	值类型
`api_key`	（私人频道所需）指定此特定频道的读取API密钥。读取API键在API键频道视图的选项卡。	细绳
`结果`	（可选）检索的条目数，最大8000。	整数
`天`	（可选的）24小时期间的数量现在包括在内。默认值为1。	整数
`时区`	（可选）标识符时区参考为此请求。	细绳
`抵消`	（可选的）时区偏移结果显示在中。使用时区参数以提高准确性。	整数

小费

这结果参数确定查询要检索的最大条目数，最高为8000。默认时间跨度限制为1天（24小时）。要获得超过1天的结果并限制条目，请同时使用结果和天参数在一起。

成功

HTTP状态代码

200好

如果您无法访问该频道，则响应为-1。

身体

JSON示例

XML示例

CSV示例

错误

有关完整列表，请参阅错误代码。

如果您无法访问该频道，则响应为-1。

例子

您可以使用Web浏览器来完成http请求，以获取the theSpepeak™的Restful API。要查看HTTP响应的格式，请单击链接或将其复制到浏览器。

读取三个状态的结果

276330频道存储办公工厂的土壤水分信息。您可以从此公共渠道读取数据。响应的格式发生在任何查询字符串参数之前在URL的末尾。此示例返回从频道276330中的最后一个状态条目JSON格式。在问号之后附加第一个参数？。您可以使用结果参数来控制返回的条目，最高为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键api_key。在问号之后附加第一个参数？。使用anmpersand和要附加第二个参数。在这种情况下，结果参数用于返回五个结果。

https://api.thingspeak.com/channels/276330/status.csv?api_key = e52awrav1rav1rav1rsxqjjw&results = 5