Main Content

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

Read Last Field Entry

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

请求

HTTP方法

GET

URL

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

URL 参数

名称描述

<channel_id>

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

<field_id>

(必填)感兴趣字段的字段 ID。

<format>

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

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

查询字符串参数

名称描述值类型
api_key

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

字符串

timezone

(可选)来自 时区参考 的请求。

字符串

offset

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

整数

status

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

truefalse

location

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

truefalse

prepend

(可选)在 API 响应之前添加的文本。

字符串
append

(可选)在 API 响应后添加的文本。

字符串

示例

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

读取 JSON 格式的最后一个条目

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

https://api.thingspeak.com/channels/9/fields/2/last.json

读取最后一个条目,包括 XML 格式的位置

当您包含 offset 参数时,ThingSpeak 返回具有指定的 GMT 偏移量的时间数据。在问号 ? 之后附加第一个参数。此请求以 XML 格式返回结果。

https://api.thingspeak.com/channels/9/fields/2/last.xml?offset=3

从私有通道读取 CSV 格式的最后条目(包括状态)

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

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

响应

成功

HTTP 状态代码

200 OK

主体

 文本示例

 JSON 示例

 XML 示例

 CSV 示例

错误

完整列表请参见 错误代码

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