主要内容

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

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 密钥。使用查询字符串参数 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。