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

Read Last Status

使用 HTTP GET 读取通道的最新状态

请求

HTTP 方法

GET

URL

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

URL 参数

名称描述

<channel_id>

（必填）感兴趣通道的通道 ID。

<format>

（必需）HTTP 响应的格式，指定为 json、xml、csv 或 txt。

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

查询字符串参数

名称描述值类型
api_key

（私有通道必需）为此特定通道指定读取 API 密钥。读取 API 密钥位于通道视图的 API Keys 选项卡上。

字符串

示例

您可以使用 Web 浏览器对 ThingSpeak™ 的 RESTful API 完成 GET HTTP 请求。要查看 HTTP 响应的格式，请点击链接或将其复制到您的浏览器。

以 JSON 格式读取最新状态

通道 276330 存储办公室植物的土壤湿度信息。您可以从这个公共通道读取数据。响应的格式出现在 URL 的末尾，在任何查询字符串参数之前。此示例以 JSON 格式返回来自通道 9 的最后一个状态条目。

https://api.thingspeak.com/channels/276330/status/last.json

以 XML 格式读取 Office Plant 通道的最新状态

通道 276330 存储办公室植物的土壤湿度信息。在请求中使用扩展名 XML 以 XML 格式返回最后的状态。

https://api.thingspeak.com/channels/276330/status/last.xml

以 JSON 格式从私人通道读取最新状态

要从私有通道读取数据，请在参数 api_key 后提供读取 API 密钥。在问号后追加第一个参数 ?。

https://api.thingspeak.com/channels/276330/status/last.json?api_key=E52AWRAV1RSXQQJW

响应

成功

HTTP 状态代码

200 OK

主体
GET https://api.thingspeak.com/channels/9/status/last.json

响应是最新状态的 JSON 对象，例如：

{
"created_at": "2018-01-25T20:05:28Z",
"entry_id": 8153,
"status": "Penny"
}
GET https://api.thingspeak.com/channels/9/status/last.xml

响应是最新状态的 XML 对象，例如： 

<feed>
<created-at type="dateTime">2018-01-25T20:05:28Z</created-at>
<entry-id type="integer">8153</entry-id>
<status>Penny</status>
<id type="integer" nil="true"/>
</feed>
GET https://api.thingspeak.com/channels/9/status/last.text

响应是最新的状态，例如：

Penny

错误

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

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

另请参阅

函数

主题