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

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 响应的格式，指定为 json、xml、csv 或 txt。

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

查询字符串参数

名称描述值类型
api_key

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

字符串

timezone

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

字符串

offset

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

整数

status

（可选）通过设置 "status=true" 在源中包含状态更新。

true 或 false

location

（可选）通过设置 "location=true" 在源中包含纬度、经度和海拔。

true 或 false

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 密钥。使用查询字符串参数 api_key 指定 API 密钥。每个条目还有一个状态字段。在这个示例中，status=true 与源数据一起返回最后一个字段的通道状态条目。在与号 & 后追加第二个参数。

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

响应

成功

HTTP 状态代码

200 OK

主体
GET https://api.thingspeak.com/channels/12397/fields/4/last.txt

响应是最新的字段源，例如：

31.8
GET https://api.thingspeak.com/channels/12397/fields/4/last.json

响应是最新字段源的 JSON 对象，例如：

{
  "created_at":"2016-02-10T16:34:15Z",
  "entry_id":877778,
  "field4":"31.8"
}
GET https://api.thingspeak.com/channels/12397/fields/4/last.xml

响应是通道源的 XML 对象，例如： 

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <created-at type="dateTime">2016-02-10T16:37:16Z</created-at>
  <entry-id type="integer">877781</entry-id>
  <field4>32.3</field4>
</feed>
GET https://api.thingspeak.com/channels/12397/fields/4/last.csv

响应是通道源的 CSV 对象，例如： 

created_at,entry_id,field4
2017-10-10 21:11:12 UTC,2017-10-10 21:11:12 UTC,1564099,1564099,84.5,84.5

错误

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

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

另请参阅

函数

主题