主要内容

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

Read Specific Entry ID

使用 HTTP GET 读取特定条目 ID

请求

HTTP 方法

GET

URL

https://api.thingspeak.com/channels/feeds/CHANNEL_ID/feeds/ENTRY ID.FORMAT

URL 参数

名称描述

ENTRY_ID

(必填)感兴趣条目的条目 ID。

.FORMAT

HTTP 响应的格式,指定为 .json、.xml、.csv 或 .txt。

主体

名称描述值类型
api_key

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

用户 API 字符串

timezone

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

时区

offset

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

整数

status

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

truefalse

location

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

truefalse

响应

成功

HTTP 状态代码

200 OK

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

主体

JSON 示例XML 示例CSV 示例
GET https://api.thingspeak.com/channels/9/feeds/6061519.json
GET https://api.thingspeak.com/channels/9/feeds/6061519.xml
GET https://api.thingspeak.com/channels/9/feeds/6061519.csv

响应是源条目的 JSON 对象,例如:

{
  "created_at": "2014-02-26T21:27:21Z",
  "entry_id": 6061519,
  "field1": "176",
  "field2": "28.195329087048833"
}

响应是最新源的 XML 对象,例如:

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <created-at type="dateTime">2014-02-26T21:27:21Z</created-at>
  <entry-id type="integer">6061519</entry-id>
  <field1>176</field1>
  <field2>28.195329087048833</field2>
  <id type="integer" nil="true"/>
</feed>

响应是通道源的 CSV 对象,例如:

created_at,entry_id,field1,field2
2014-02-26 21:27:21 UTC,2014-02-26 21:27:21 UTC,6061519,6061519,176,176,28.195329087048833,28.195329087048833

错误

完整列表请参阅错误代码

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