Main Content

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

Read Last Entry

使用 HTTP GET 读取通道中的最后一个条目

请求

HTTP方法

GET

URL

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

URL 参数

名称描述

<channel_id>

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

<format>

(必需)HTTP 响应的格式,指定为 jsonxmlcsvtxt

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

查询字符串参数

名称描述值类型
api_key

(私有通道必需)为此特定通道指定读取 API 密钥。读取 API 密钥可在通道视图的 API Keys 选项卡上找到。

字符串

timezone

(可选)来自 时区参考 的此请求的标识符。

字符串

offset

(可选)显示结果的时区偏移量。使用时区参数可以获得更高的准确性。

整数

status

(可选)通过设置“status=true”在源中包含状态更新。

truefalse

location

(可选)通过设置“location=true”在源中包含纬度、经度和海拔。

truefalse

示例

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

读取最后一个条目,并以 JSON 格式提供结果

通道 9 包含来自多个家庭环境传感器的信息。您可以从此公共通道读取数据。响应的格式出现在 URL 末尾、任何查询字符串参数之前。此示例以 JSON 格式返回通道9 中的最后一个条目。

https://api.thingspeak.com/channels/9/feeds/last.json

读取最后一个条目(包括位置),并以 XML 格式提供结果

当您包含 location=true 时,ThingSpeak 返回最后一个条目的位置信息。条目位置信息与在Channel Settings选项卡上设置的通道位置信息不同。在问号 ? 之后附加第一个参数。此请求以 XML 格式返回结果。

https://api.thingspeak.com/channels/9/feeds/last.xml?location=true

从私有通道读取最后的条目(包括状态),并以 CSV 格式提供结果

当您请求csv 格式的输出时,返回的文件是逗号分隔的变量格式。根据您的计算机配置,您的浏览器可以启动其他软件来显示此格式。从私有通道读取需要读取 API Key。使用查询字符串参数 api_key 指定 API 密钥。每个条目还有一个状态字段。在此示例中,status=true 返回最后一个字段的通道状态条目以及源数据。在 & 符号 & 之后附加第二个参数。

https://api.thingspeak.com/channels/9/feeds/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

响应

成功

HTTP 状态代码

200 OK

主体

 JSON 或文本示例

 XML 示例

 CSV 示例

错误

完整列表请参见 错误代码

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